How seyaff/autonomous-agents works
This is a multi-tenant restaurant operations and founder-growth platform, with a web dashboard and FastAPI backend. The principal customer workflow accepts a WhatsApp interaction, routes it through the master agent, builds customer context, and uses support tools for knowledge lookup or order operations. The repository also contains account and tenant management, analytics, founder lead/outreach, and document knowledge features. Several endpoint and agent implementations are unsampled, so their capabilities are represented from the source index and routing declarations; uncertain runtime links are omitted.
Main entry points: routes.py API router · tools.py Support tools · agent.py Support agent · database.py MongoDB
Components 27
Web dashboard
- Dashboard
frontend/src/app/(dashboard)/dashboard/page.tsx - Onboarding
frontend/src/app/(dashboard)/onboarding/page.tsx - Agent client
frontend/services/agent/agent.service.ts
API and identity
- API router
app/api/v1/routes.py - Auth endpoints
app/api/v1/endpoints/auth.py - Tenant endpoints
app/api/v1/endpoints/tenant.py - Agent endpoint
app/api/v1/endpoints/agent.py - WhatsApp endpoint
app/api/v1/endpoints/whatsapp.py - Analytics endpoint
app/api/v1/endpoints/analytics.py - Founder endpoint
app/api/v1/endpoints/founder.py - Knowledge endpoint
app/api/v1/endpoints/knowledge.py - Auth middleware
app/middlewares/auth_middleware.py
Agents and operations
- Master agent
app/agents/central_agent.py - Support agent
app/agents/customer_support/agent.py - Support tools
app/agents/customer_support/tools.py - Lead generation
app/agents/founder/lead_generator.py - Founder outreach
app/agents/founder/outreach_agent.py - Weekly analytics
app/agents/analytics/weekly_report.py
Knowledge and memory
- Context builder
app/memory/context_builder.py - Customer memory
app/memory/customer_memory.py - Conversation checkpoint
app/memory/mongo_checkpointer.py - Knowledge ingestion
app/services/knowledge_ingestion.py - PDF ingestion
app/services/pdf_ingestion.py
Platform state
- MongoDB
app/core/database.py - Pinecone vectors
Other components
- User
Connections 34
- User → Dashboard: uses
- Dashboard → Agent client: requests agent
- Agent client → Agent endpoint: calls
- User → Onboarding: sets up tenant
- Onboarding → Tenant endpoints: configures tenant
- API router → Auth endpoints: routes to
app/api/v1/routes.py - API router → Tenant endpoints: routes to
app/api/v1/routes.py - API router → Agent endpoint: routes to
app/api/v1/routes.py - API router → WhatsApp endpoint: routes to
app/api/v1/routes.py - API router → Analytics endpoint: routes to
app/api/v1/routes.py - API router → Founder endpoint: routes to
app/api/v1/routes.py - API router → Knowledge endpoint: routes to
app/api/v1/routes.py - Agent endpoint → Master agent: invokes
app/api/v1/endpoints/agent.py - Master agent → Support agent: dispatches to
app/agents/central_agent.py - Support agent → Support tools: uses tools
app/agents/customer_support/agent.py - Support agent → Context builder: builds context
app/memory/context_builder.py - Context builder → Support agent: reads state
app/memory/context_builder.py - Context builder → Customer memory: loads profile
app/memory/context_builder.py - Support agent → Conversation checkpoint: checkpoints
app/agents/customer_support/agent.py - Support tools → Knowledge ingestion: searches knowledge
app/agents/customer_support/tools.py - Support tools → PDF ingestion: uses PDF ingestion
app/agents/customer_support/tools.py - Support tools → Customer memory: updates profile
app/agents/customer_support/tools.py - Support tools → MongoDB: reads/writes orders
app/agents/customer_support/tools.py - Knowledge ingestion → MongoDB: records documents
app/services/knowledge_ingestion.py - Knowledge ingestion → Pinecone vectors: upserts and searches
app/services/knowledge_ingestion.py - PDF ingestion → Pinecone vectors: stores embeddings
app/services/pdf_ingestion.py - Auth endpoints → MongoDB: manages accounts
app/api/v1/endpoints/auth.py - Auth endpoints → Auth middleware: checks identity
app/api/v1/endpoints/auth.py - Auth middleware → MongoDB: loads user
app/middlewares/auth_middleware.py - Tenant endpoints → MongoDB: manages tenant
app/api/v1/endpoints/tenant.py - Analytics endpoint → Weekly analytics: uses report
app/api/v1/endpoints/analytics.py - Founder endpoint → Lead generation: invokes
app/api/v1/endpoints/founder.py - Founder endpoint → Founder outreach: invokes
app/api/v1/endpoints/founder.py - WhatsApp → WhatsApp endpoint: sends messages