How myassistantapps/myassistant-backend works
MYASSISTANT is a voice-first personal assistant backend: the app sends authenticated chat or voice turns, Hari interprets them, selects capabilities, and returns spoken or streamed results while recording consequential actions. Separate product branches handle real-world errands, inbound and outbound calls, knowledge retrieval, meetings, payments, Google services, and avatar sessions. The README documents several capabilities whose implementation was not sampled; those appear as subsystem nodes without speculative internal wiring. Edges are limited to shown imports/calls or README-described relationships.
Main entry points: runtime.js Agent runtime · db.js PostgreSQL data · routes.js Realtime voice loop · server.js Express API
Components 24
API and conversation
- Express API
src/server.js - Realtime voice loop
src/assistant/routes.js - Chat and intents
src/routes/chat.js
Agent execution
- Agent runtime
src/agents/runtime.js - Tool registry
src/tools/registry.js - Gemini services
src/services/ai/router.js
Assistant capabilities
- Knowledge retrieval
src/knowledge/engine.js - Errand fulfillment
src/fulfillment/service.js - Meeting negotiation
src/meetings/service.js - Flight fares
src/travel/fares.js - Interpreter mode
src/interpreter/mode.js - Reminders
src/reminders/routes.js
External integrations
- Outbound agent calls
src/agents/agentCall.js - Inbound call screening
src/inbound/receptionist.js - MCP integrations
src/mcp/manager.js - Google services
src/google/routes.js - Payment collection
src/payments/service.js - Avatar sessions
src/avatar/session.js
User state and records
- User context
src/users/context.js - Personal memory
src/agents/memory.js - Executed actions
src/actions/store.js - Action audit
src/audit/log.js - PostgreSQL data
src/db.js
Other components
- MYASSISTANT app
Connections 24
- MYASSISTANT app → Express API: sends requests
README.md - Express API → Realtime voice loop: mounts routes
src/server.js - MYASSISTANT app → Realtime voice loop: streams voice turns
README.md - Realtime voice loop → Agent runtime: runs turns
src/assistant/routes.js - Realtime voice loop → Chat and intents: uses intents
src/assistant/routes.js - Agent runtime → Tool registry: selects tools
src/agents/runtime.js - Agent runtime → Gemini services: requests generation
src/agents/runtime.js - Agent runtime → User context: loads context
src/agents/runtime.js - Agent runtime → Personal memory: uses memory
src/agents/runtime.js - Agent runtime → Executed actions: records execution
src/agents/runtime.js - Tool registry → MCP integrations: accepts user tools
README.md - Errand fulfillment → Outbound agent calls: places calls
src/fulfillment/service.js - Errand fulfillment → PostgreSQL data: stores errands
src/fulfillment/service.js - Inbound call screening → Express API: receives webhooks
- Meeting negotiation → Gemini services: analyzes transcripts
src/meetings/service.js - Google services → Express API: serves endpoints
src/google/routes.js - Payment collection → PostgreSQL data: stores payment state
src/payments/service.js - Avatar sessions → MYASSISTANT app: provides sessions
README.md - Knowledge retrieval → PostgreSQL data: loads entries
src/knowledge/engine.js - Personal memory → PostgreSQL data: persists memories
- Action audit → PostgreSQL data: writes audit log
src/audit/log.js - Reminders → PostgreSQL data: stores reminders
- Flight fares → MYASSISTANT app: offers fare search
README.md - Interpreter mode → MYASSISTANT app: translates speech
README.md