How ugbodagadave/isabella works
Isabella is a Slack-based bookkeeping agent for accountants. Its main workflow accepts receipt images or PDFs in Slack, extracts and structures expense details, and appends them to Google Sheets; users can also ask natural-language questions and receive financial summaries in Slack. The graph separates intake/orchestration, extraction and AI, query analysis, and spreadsheet storage. The runner’s wiring and several component calls are visible in sampled source; Slack event handling and some controller behavior are represented only by README statements and the source index.
Main entry points: controller.py Workflow Controller · slack_socket_runner.py Socket Runner · slack_interface.py Slack Interface · granite_client.py Granite Client
Components 17
Slack Intake
- Socket Runner
tools/slack_socket_runner.py - Slack Interface
tools/slack_interface.py - Workflow Controller
tools/controller.py - Runtime Settings
config/settings.py
Receipt Processing
- Text Extractor
tools/text_extractor.py - Vision Client
models/vision_client.py - Receipt Processor
tools/receipt_processor.py - Granite Client
models/granite_client.py - Receipt Schema
data/schemas/receipt_schema.json - AI Prompts
config/prompts.py
Expense Analysis
- Query Analyzer
tools/query_analyzer.py
Financial Records
- Sheets Manager
tools/sheets_manager.py - Google Sheets Client
integrations/google_sheets_api.py - Expense Spreadsheet
Other components
- Accountant
- Slack
- IBM watsonx
Connections 23
- Accountant → Slack: uploads or asks
README.md - Slack → Slack Interface: delivers events
README.md - Slack Interface → Workflow Controller: routes requests
- Workflow Controller → Text Extractor: extracts text
tools/controller.py - Text Extractor → Vision Client: transcribes images
tools/text_extractor.py - Workflow Controller → Receipt Processor: processes receipt
tools/controller.py - Receipt Processor → Granite Client: generates structured data
tools/receipt_processor.py - Receipt Processor → Receipt Schema: validates against
tools/receipt_processor.py - Workflow Controller → Sheets Manager: stores expenses
tools/controller.py - Sheets Manager → Google Sheets Client: appends and queries
tools/sheets_manager.py - Google Sheets Client → Expense Spreadsheet: reads and writes
integrations/google_sheets_api.py - Workflow Controller → Query Analyzer: plans queries
tools/controller.py - Query Analyzer → Granite Client: uses model
- Workflow Controller → Sheets Manager: fetches expense rows
tools/controller.py - Workflow Controller → Slack Interface: returns reports
README.md - Slack Interface → Slack: posts results
README.md - Socket Runner → Workflow Controller: wires components
tools/slack_socket_runner.py - Socket Runner → Slack Interface: starts interface
tools/slack_socket_runner.py - Socket Runner → Runtime Settings: loads configuration
tools/slack_socket_runner.py - Socket Runner → Google Sheets Client: connects client
tools/slack_socket_runner.py - Socket Runner → Granite Client: creates client
tools/slack_socket_runner.py - IBM watsonx → Granite Client: serves text generation
models/granite_client.py - IBM watsonx → Vision Client: serves vision inference
models/vision_client.py