How razinuom/guh-2026-krunchy works
Heirloom is a family-focused money coaching app: people select a family member, view forecasts and hardship warnings, explore long-term gifting scenarios, check online money claims, or opt into multilingual voice coaching. The React pages call FastAPI endpoints; backend services share synthetic persona and transaction data across the modelling features. The README documents the frontend/backend contract and optional ElevenLabs and Firecrawl capabilities. Several feature paths are supported by README or source-index references, but their endpoint implementations were not sampled, so unverified internal links are omitted.
Main entry points: main.py FastAPI endpoints · routes.tsx Page routing · router.py Voice tools and sessions · api.ts HTTP client
Components 26
Web experience
- React app
frontend/src/app/App.tsx - Page routing
frontend/src/app/routes.tsx - Family dashboard
frontend/src/pages/Family.tsx - Cash forecast
frontend/src/pages/Forecast.tsx - Time Machine
frontend/src/pages/TimeMachine.tsx - Claim Check
frontend/src/pages/ClaimCheck.tsx - Voice Coach
frontend/src/pages/VoiceCoach.tsx - HTTP client
frontend/src/lib/api.ts
Backend API
- FastAPI endpoints
backend/main.py - Hardship endpoints
backend/hardship/api.py
Financial modelling
- Family personas
backend/heirloom/personas.py - Synthetic transactions
backend/heirloom/synth.py - Forecast service
backend/heirloom/service.py - 90-day simulation
backend/heirloom/forecast.py - Risk assessment
backend/hardship/service.py - Risk features
backend/hardship/features.py - Household simulator
backend/hardship/simulate.py - 25-year scenarios
backend/heirloom/timemachine.py
Guidance and voice
- Claim evaluation
backend/heirloom/claimcheck.py - Money guidance
backend/heirloom/guidance.py - Knowledge search
backend/voice/kb_search.py - Voice tools and sessions
backend/voice/router.py - Agent definition
backend/voice/agent_spec.py
Other components
- Family member
- ElevenLabs agent
- Firecrawl search
Connections 36
- Family member → React app: uses
README.md - React app → Page routing: renders
frontend/src/app/App.tsx - Page routing → Family dashboard: routes to
frontend/src/app/routes.tsx - Page routing → Cash forecast: routes to
frontend/src/app/routes.tsx - Page routing → Time Machine: routes to
frontend/src/app/routes.tsx - Page routing → Claim Check: routes to
frontend/src/app/routes.tsx - Page routing → Voice Coach: loads
frontend/src/app/routes.tsx - Family dashboard → HTTP client: requests data
- Cash forecast → HTTP client: requests forecast
- Time Machine → HTTP client: requests scenarios
- Claim Check → HTTP client: submits claims
- Voice Coach → HTTP client: starts session
- HTTP client → FastAPI endpoints: HTTP requests
README.md - FastAPI endpoints → Family personas: reads members
backend/main.py - FastAPI endpoints → Forecast service: calls forecast
backend/main.py - Forecast service → Synthetic transactions: loads feed
backend/heirloom/service.py - Forecast service → 90-day simulation: runs forecast
backend/heirloom/service.py - FastAPI endpoints → 25-year scenarios: runs scenarios
backend/main.py - FastAPI endpoints → Claim evaluation: checks claim
backend/main.py - FastAPI endpoints → Money guidance: answers questions
backend/main.py - FastAPI endpoints → Hardship endpoints: mounts routes
backend/main.py - Hardship endpoints → Risk assessment: calls assessment
backend/hardship/api.py - Risk assessment → Risk features: scores features
backend/hardship/service.py - Risk assessment → Synthetic transactions: loads shared feed
backend/hardship/service.py - Household simulator → Risk features: generates training data
- FastAPI endpoints → Voice tools and sessions: mounts routes
backend/main.py - Voice tools and sessions → Forecast service: runs forecast tool
backend/voice/router.py - Voice tools and sessions → Family personas: looks up members
backend/voice/router.py - Voice tools and sessions → Agent definition: uses tool definitions
backend/voice/router.py - Voice tools and sessions → ElevenLabs agent: requests sessions
README.md - ElevenLabs agent → Voice tools and sessions: calls tools
README.md - Claim evaluation → Knowledge search: searches sources
backend/heirloom/claimcheck.py - Money guidance → Knowledge search: searches knowledge
backend/heirloom/guidance.py - Claim evaluation → Firecrawl search: optional live search
README.md - Synthetic transactions → Family personas: generates from
backend/heirloom/synth.py - 25-year scenarios → Family personas: uses profiles
backend/heirloom/timemachine.py