How haseebashfaq488/ai-automation works
Jarvis is an AI automation control plane: users interact through a Next.js dashboard, while a FastAPI backend exposes agent, task, worker, tool, skill, and pipeline operations. Worker execution turns agent decisions into tool calls; separate pipelines support file organization, email, and WhatsApp workflows. The tree documents integrations and UI surfaces, but most of their implementations were not sampled, so those branches are shown at subsystem level and uncertain wiring is omitted.
Main entry points: main.py FastAPI App · engine.py Worker Engine · pipelines Automation Pipelines · api.js Frontend API Client
Components 28
Dashboard
- Dashboard
AI-Automation Frontend/app/page.js - Workers UI
AI-Automation Frontend/app/workers/page.js - Worker Detail
AI-Automation Frontend/app/worker/[id]/page.js - Chat And Controls
AI-Automation Frontend/app/components/Chat.js - Frontend API Client
AI-Automation Frontend/app/lib/api.js
API Control Plane
- FastAPI App
backend/app/main.py - Agent Routes
backend/app/api/routes/agent.py - Task Routes
backend/app/api/routes/tasks.py - Worker Routes
backend/app/api/routes/workers.py - Pipeline Routes
backend/app/api/routes/pipelines.py
Agent Execution
- Worker Engine
backend/app/workers/base/engine.py - Worker Agents
backend/app/workers/antigravity_worker/agent/worker_agent.py - Tool Execution
backend/app/core/execution_engine.py - Tool Registry
backend/app/registry/tool_registry.py
Automation Modules
- Automation Pipelines
backend/app/modules/file_management/pipelines - File Management
backend/app/modules/file_management/tools - Gmail Skills And Tools
backend/app/modules/gmail - Drive Skills And Tools
backend/app/modules/drive - WhatsApp Skills And Tools
backend/app/modules/whatsapp
State And Events
- Conversation Memory
backend/app/modules/memory - Event Bus
backend/app/core/events/bus.py - Database And Repository
backend/app/modules/database/repository.py
External Services
- WhatsApp Web Service
backend/whatsapp_service/server.js - Gmail
- Google Drive
- Antigravity CLI
- OpenCode CLI
Other components
- User
Connections 25
- User → Dashboard: uses
- User → Workers UI: manages workers
- Dashboard → Chat And Controls: interacts through
- Dashboard → Frontend API Client: requests through
- Workers UI → Frontend API Client: requests through
- Worker Detail → Frontend API Client: requests through
- Frontend API Client → FastAPI App: HTTP requests
- FastAPI App → Agent Routes: routes requests
- FastAPI App → Task Routes: routes requests
- FastAPI App → Worker Routes: routes requests
- FastAPI App → Pipeline Routes: routes requests
- Worker Engine → Worker Agents: requests decisions
- Worker Engine → Tool Execution: runs tool steps
- Tool Execution → Tool Registry: looks up tools
- Pipeline Routes → Automation Pipelines: runs selected pipeline
- Automation Pipelines → File Management: uses file capabilities
- Automation Pipelines → Gmail Skills And Tools: runs email workflows
- Automation Pipelines → WhatsApp Skills And Tools: runs messaging workflows
- WhatsApp Skills And Tools → WhatsApp Web Service: calls service
- Gmail Skills And Tools → Gmail: uses integration
- Drive Skills And Tools → Google Drive: uses integration
- Worker Agents → Antigravity CLI: CLI integration
- Worker Agents → OpenCode CLI: CLI integration
- Worker Engine → Event Bus: emits execution events
- Worker Engine → Database And Repository: session state