How rlg0013/memory-driven-personal-financial-tracker-hackathon- works
HisaabAI is a memory-driven personal-finance assistant: SMS alerts and user goals/events become structured financial memories, which support reports, pattern/overspending analysis, savings guidance, and conversational answers. The sampled backend shows the API dispatching these workflows to parsing, memory, and agent modules; the README documents Mem-Brain’s graph role. The frontend excerpt confirms dashboard requests and graph exploration, but React page/component files were unsampled, so the graph uses the existing frontend entry point and omits uncertain UI wiring.
Main entry points: main.py FastAPI service · memory_graph.py Memory graph · agent.py Finance agent · sms_parser.py SMS parser
Components 19
User interface
- Finance dashboard
frontend/app.js - Memory graph explorer
frontend/app.js
API workflows
- FastAPI service
backend/main.py - Transaction ingestion
backend/main.py - Goals and events
backend/main.py - Monthly reporting
backend/main.py - Pattern analysis
backend/main.py - Overspending analysis
backend/main.py - Savings planning
backend/main.py - Goal reasoning
backend/main.py - Finance chat
backend/main.py - Memory search
backend/main.py
Finance intelligence
- SMS parser
backend/sms_parser.py - Finance agent
backend/agent.py
Memory and providers
- Memory graph
backend/memory_graph.py - Mem-Brain
- OpenRouter model
- Claude parser model
Other components
- Finance user
Connections 28
- Finance user → Finance dashboard: uses
- Finance dashboard → FastAPI service: HTTP requests
- FastAPI service → Transaction ingestion: dispatches
- Transaction ingestion → SMS parser: parses messages
- Transaction ingestion → Memory graph: stores transactions
- SMS parser → Memory graph: looks up categories
- SMS parser → Claude parser model: enriches as needed
- Memory graph → Mem-Brain: reads and writes
- FastAPI service → Goals and events: dispatches
- Goals and events → Memory graph: stores goals/events
- FastAPI service → Monthly reporting: dispatches
- Monthly reporting → Finance agent: generates report
- FastAPI service → Pattern analysis: dispatches
- Pattern analysis → Finance agent: detects and explains
- FastAPI service → Overspending analysis: dispatches
- Overspending analysis → Memory graph: analyzes spending
- FastAPI service → Savings planning: dispatches
- Savings planning → Finance agent: creates plan
- FastAPI service → Goal reasoning: dispatches
- Goal reasoning → Memory graph: retrieves goal context
- FastAPI service → Finance chat: dispatches
- Finance chat → Finance agent: asks question
- Finance agent → Memory graph: retrieves context
- Finance agent → OpenRouter model: requests answer
- FastAPI service → Memory graph explorer: serves graph data
- Memory graph explorer → FastAPI service: requests graph
- FastAPI service → Memory search: dispatches
- Memory search → Memory graph: searches memories