How fosowl/agenticseek works
AgenticSeek is a local, voice-capable assistant that routes user requests to specialized agents for browsing, coding, file work, or planning multi-step tasks. The main flow is query submission, task classification, agent execution with tools and memory, and an answer returned through the API. The README also describes a React web interface, local LLM options, and voice input/output. Some backend wiring is not shown in the excerpts, so uncertain links are omitted or marked dashed.
Main entry points: planner_agent.py Task planner · interaction.py Interaction · api.py Query API · browser_agent.py Browser agent
Components 20
User interfaces
- Web interface
frontend/agentic-seek-front/src/App.js - Query API
api.py - CLI
cli.py
Task orchestration
- Interaction
sources/interaction.py - Task router
sources/router.py - Task planner
sources/agents/planner_agent.py
Agents and tools
- Agent base
sources/agents/agent.py - Browser agent
sources/agents/browser_agent.py - Code agent
sources/agents/code_agent.py - General agent
sources/agents/casual_agent.py - File agent
sources/agents/file_agent.py - Agent tools
sources/tools - Browser control
sources/browser.py
Local runtime
- Conversation memory
sources/memory.py - LLM provider
sources/llm_provider.py - Local LLM server
llm_server/app.py - Speech input
sources/speech_to_text.py - Speech output
sources/text_to_speech.py - Workspace files
sources/workspace.py
Other components
- User
Connections 23
- User → Web interface: submits query
- User → CLI: submits query
- User → Query API: submits query
api.py - Web interface → Query API: sends query
- Query API → Interaction: processes query
api.py - CLI → Interaction: starts interaction
cli.py - Interaction → Task router: routes request
sources/interaction.py - Task router → Task planner: selects agent
sources/router.py - Task planner → Browser agent: delegates task
sources/agents/planner_agent.py - Task planner → Code agent: delegates task
sources/agents/planner_agent.py - Task planner → File agent: delegates task
sources/agents/planner_agent.py - Task planner → General agent: delegates task
sources/agents/planner_agent.py - Browser agent → Browser control: controls browser
sources/agents/browser_agent.py - Browser agent → Agent tools: searches web
sources/agents/browser_agent.py - General agent → Agent tools: uses tools
sources/agents/casual_agent.py - File agent → Agent tools: uses tools
sources/agents/file_agent.py - Agent base → Conversation memory: reads and updates
sources/agents/agent.py - Agent base → LLM provider: requests completion
- Task planner → Agent base: inherits from
sources/agents/planner_agent.py - Interaction → Speech input: captures speech
sources/interaction.py - Interaction → Speech output: speaks response
sources/interaction.py - Query API → Workspace files: uses workspace
api.py - LLM provider → Local LLM server: requests generation