How ganganidhanush-maker/pacific works
Octopus AI is a teacher- and student-facing desktop assistant whose main workflow accepts a chat or voice request, routes it through a master agent, and returns a response or carries out an automation. The README documents five agent roles and web, desktop, research, and tutoring capabilities. The sampled server code shows agent dispatch, browser setup, and research/chatbot calls; the README supports the broader agent map. Some subsystem wiring is therefore shown only where documented, and uncertain links are omitted.
Main entry points: app.py FastAPI Backend · orchestrator.py Master Orchestrator · local_llm_service.py Local LLM Service · desktop_agent.py Desktop Agent
Components 22
User Interaction
- Desktop UI
octopus_ai/interface/desktop_app.py - Chat Interface
octopus_ai/interface/chat.py - FastAPI Backend
octopus_ai/server/app.py
Agent Reasoning
- Master Orchestrator
octopus_ai/agent/orchestrator.py - Web Agent
octopus_ai/agent/subagents/web_agent.py - Desktop Agent
octopus_ai/agent/subagents/desktop_agent.py - Research Agent
octopus_ai/agent/subagents/research_agent.py - Chatbot Agent
octopus_ai/agent/subagents/chatbot_agent.py
Task Execution
- Web Automations
octopus_ai/automations/web - Desktop Tasks
octopus_ai/automations/desktop/system_task.py - Computer Use
octopus_ai/computer_use/computer_agent.py - Action Router
octopus_ai/computer_use/router.py - Windows Adapter
octopus_ai/computer_use/adapters/windows_use_adapter.py - Clacky Adapter
octopus_ai/computer_use/adapters/clacky_adapter.py - Browser Engine
octopus_ai/engine/selenium_engine.py
State And Services
- Execution Preview
octopus_ai/automations/preview/preview_manager.py - Local LLM Service
octopus_ai/server/local_llm_service.py - Kimi Provider
octopus_ai/agent/kimi_llm.py - Groq Provider
octopus_ai/agent/groq_llm.py - Persistent Memory
octopus_ai/memory/persistent_memory.py - Voice Service
octopus_ai/server/voice_service.py
Other components
- Student Or Teacher
Connections 24
- Student Or Teacher → Desktop UI: submits request
- Student Or Teacher → Chat Interface: submits request
- Desktop UI → FastAPI Backend: sends requests
- Chat Interface → FastAPI Backend: sends requests
- FastAPI Backend → Master Orchestrator: routes tasks
- Master Orchestrator → Web Agent: dispatches
- Master Orchestrator → Desktop Agent: dispatches
- Master Orchestrator → Research Agent: dispatches
- Master Orchestrator → Chatbot Agent: dispatches
- FastAPI Backend → Research Agent: calls research
- FastAPI Backend → Chatbot Agent: calls chat
- Web Agent → Web Automations: runs web tasks
- Web Automations → Browser Engine: controls browser
- FastAPI Backend → Browser Engine: initializes
- Desktop Agent → Desktop Tasks: runs desktop tasks
- Desktop Agent → Computer Use: uses computer
- Computer Use → Action Router: executes actions
- Action Router → Windows Adapter: controls Windows
- Action Router → Clacky Adapter: uses companion
- FastAPI Backend → Execution Preview: sets browser driver
- Local LLM Service → Persistent Memory: queries knowledge
- Local LLM Service → Kimi Provider: tries provider
- Local LLM Service → Groq Provider: tries provider
- FastAPI Backend → Voice Service: generates speech