# fosowl/agenticseek architecture

> Architecture diagram of the GitHub repository fosowl/agenticseek, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fosowl/agenticseek
- Repository: https://github.com/fosowl/agenticseek

## Overview

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: [`sources/agents/planner_agent.py`](https://github.com/fosowl/agenticseek/blob/main/sources/agents/planner_agent.py) (Task planner), [`sources/interaction.py`](https://github.com/fosowl/agenticseek/blob/main/sources/interaction.py) (Interaction), [`api.py`](https://github.com/fosowl/agenticseek/blob/main/api.py) (Query API), [`sources/agents/browser_agent.py`](https://github.com/fosowl/agenticseek/blob/main/sources/agents/browser_agent.py) (Browser agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_web_ui["Web interface<br/>[App.js]"]
  node_api["Query API<br/>[api.py]"]
  node_cli["CLI<br/>[cli.py]"]
end

subgraph group_orchestration["Task orchestration"]
  node_interaction["Interaction<br/>[interaction.py]"]
  node_router["Task router<br/>[router.py]"]
  node_planner["Task planner<br/>[planner_agent.py]"]
end

subgraph group_execution["Agents and tools"]
  node_agent_base["Agent base<br/>[agent.py]"]
  node_browser_agent["Browser agent<br/>[browser_agent.py]"]
  node_code_agent["Code agent<br/>[code_agent.py]"]
  node_casual_agent["General agent<br/>[casual_agent.py]"]
  node_file_agent["File agent<br/>[file_agent.py]"]
  node_tools["Agent tools"]
  node_browser["Browser control<br/>[browser.py]"]
end

subgraph group_runtime["Local runtime"]
  node_memory[("Conversation memory<br/>[memory.py]")]
  node_provider["LLM provider<br/>[llm_provider.py]"]
  node_llm_service["Local LLM server<br/>[app.py]"]
  node_speech_input["Speech input<br/>[speech_to_text.py]"]
  node_speech_output["Speech output<br/>[text_to_speech.py]"]
  node_workspace[("Workspace files<br/>[workspace.py]")]
end

node_user(("User"))

node_user -->|"submits query"| node_web_ui
node_user -->|"submits query"| node_cli
node_user -->|"submits query"| node_api
node_web_ui -.->|"sends query"| node_api
node_api -->|"processes query"| node_interaction
node_cli -->|"starts interaction"| node_interaction
node_interaction -->|"routes request"| node_router
node_router -->|"selects agent"| node_planner
node_planner -->|"delegates task"| node_browser_agent
node_planner -->|"delegates task"| node_code_agent
node_planner -->|"delegates task"| node_file_agent
node_planner -->|"delegates task"| node_casual_agent
node_browser_agent -->|"controls browser"| node_browser
node_browser_agent -->|"searches web"| node_tools
node_casual_agent -->|"uses tools"| node_tools
node_file_agent -->|"uses tools"| node_tools
node_agent_base -->|"reads and updates"| node_memory
node_agent_base -.->|"requests completion"| node_provider
node_planner -->|"inherits from"| node_agent_base
node_interaction -->|"captures speech"| node_speech_input
node_interaction -->|"speaks response"| node_speech_output
node_api -->|"uses workspace"| node_workspace
node_provider -.->|"requests generation"| node_llm_service

click node_web_ui "https://github.com/fosowl/agenticseek/blob/main/frontend/agentic-seek-front/src/App.js"
click node_api "https://github.com/fosowl/agenticseek/blob/main/api.py"
click node_cli "https://github.com/fosowl/agenticseek/blob/main/cli.py"
click node_interaction "https://github.com/fosowl/agenticseek/blob/main/sources/interaction.py"
click node_router "https://github.com/fosowl/agenticseek/blob/main/sources/router.py"
click node_planner "https://github.com/fosowl/agenticseek/blob/main/sources/agents/planner_agent.py"
click node_agent_base "https://github.com/fosowl/agenticseek/blob/main/sources/agents/agent.py"
click node_browser_agent "https://github.com/fosowl/agenticseek/blob/main/sources/agents/browser_agent.py"
click node_code_agent "https://github.com/fosowl/agenticseek/blob/main/sources/agents/code_agent.py"
click node_casual_agent "https://github.com/fosowl/agenticseek/blob/main/sources/agents/casual_agent.py"
click node_file_agent "https://github.com/fosowl/agenticseek/blob/main/sources/agents/file_agent.py"
click node_tools "https://github.com/fosowl/agenticseek/tree/main/sources/tools"
click node_browser "https://github.com/fosowl/agenticseek/blob/main/sources/browser.py"
click node_memory "https://github.com/fosowl/agenticseek/blob/main/sources/memory.py"
click node_provider "https://github.com/fosowl/agenticseek/blob/main/sources/llm_provider.py"
click node_llm_service "https://github.com/fosowl/agenticseek/blob/main/llm_server/app.py"
click node_speech_input "https://github.com/fosowl/agenticseek/blob/main/sources/speech_to_text.py"
click node_speech_output "https://github.com/fosowl/agenticseek/blob/main/sources/text_to_speech.py"
click node_workspace "https://github.com/fosowl/agenticseek/blob/main/sources/workspace.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web_ui,node_api,node_cli,node_user toneBlue
class node_interaction,node_router,node_planner toneAmber
class node_agent_base,node_browser_agent,node_code_agent,node_casual_agent,node_file_agent,node_tools,node_browser toneMint
class node_memory,node_provider,node_llm_service,node_speech_input,node_speech_output,node_workspace toneRose
```

## Components

### User interfaces

- [Web interface](https://github.com/fosowl/agenticseek/blob/main/frontend/agentic-seek-front/src/App.js): `frontend/agentic-seek-front/src/App.js`
- [Query API](https://github.com/fosowl/agenticseek/blob/main/api.py): `api.py`
- [CLI](https://github.com/fosowl/agenticseek/blob/main/cli.py): `cli.py`

### Task orchestration

- [Interaction](https://github.com/fosowl/agenticseek/blob/main/sources/interaction.py): `sources/interaction.py`
- [Task router](https://github.com/fosowl/agenticseek/blob/main/sources/router.py): `sources/router.py`
- [Task planner](https://github.com/fosowl/agenticseek/blob/main/sources/agents/planner_agent.py): `sources/agents/planner_agent.py`

### Agents and tools

- [Agent base](https://github.com/fosowl/agenticseek/blob/main/sources/agents/agent.py): `sources/agents/agent.py`
- [Browser agent](https://github.com/fosowl/agenticseek/blob/main/sources/agents/browser_agent.py): `sources/agents/browser_agent.py`
- [Code agent](https://github.com/fosowl/agenticseek/blob/main/sources/agents/code_agent.py): `sources/agents/code_agent.py`
- [General agent](https://github.com/fosowl/agenticseek/blob/main/sources/agents/casual_agent.py): `sources/agents/casual_agent.py`
- [File agent](https://github.com/fosowl/agenticseek/blob/main/sources/agents/file_agent.py): `sources/agents/file_agent.py`
- [Agent tools](https://github.com/fosowl/agenticseek/tree/main/sources/tools): `sources/tools`
- [Browser control](https://github.com/fosowl/agenticseek/blob/main/sources/browser.py): `sources/browser.py`

### Local runtime

- [Conversation memory](https://github.com/fosowl/agenticseek/blob/main/sources/memory.py): `sources/memory.py`
- [LLM provider](https://github.com/fosowl/agenticseek/blob/main/sources/llm_provider.py): `sources/llm_provider.py`
- [Local LLM server](https://github.com/fosowl/agenticseek/blob/main/llm_server/app.py): `llm_server/app.py`
- [Speech input](https://github.com/fosowl/agenticseek/blob/main/sources/speech_to_text.py): `sources/speech_to_text.py`
- [Speech output](https://github.com/fosowl/agenticseek/blob/main/sources/text_to_speech.py): `sources/text_to_speech.py`
- [Workspace files](https://github.com/fosowl/agenticseek/blob/main/sources/workspace.py): `sources/workspace.py`

### Other components

- **User**

## Connections

- User → Web interface: submits query
- User → CLI: submits query
- User → Query API: submits query (evidence: `api.py`)
- Web interface → Query API: sends query
- Query API → Interaction: processes query (evidence: `api.py`)
- CLI → Interaction: starts interaction (evidence: `cli.py`)
- Interaction → Task router: routes request (evidence: `sources/interaction.py`)
- Task router → Task planner: selects agent (evidence: `sources/router.py`)
- Task planner → Browser agent: delegates task (evidence: `sources/agents/planner_agent.py`)
- Task planner → Code agent: delegates task (evidence: `sources/agents/planner_agent.py`)
- Task planner → File agent: delegates task (evidence: `sources/agents/planner_agent.py`)
- Task planner → General agent: delegates task (evidence: `sources/agents/planner_agent.py`)
- Browser agent → Browser control: controls browser (evidence: `sources/agents/browser_agent.py`)
- Browser agent → Agent tools: searches web (evidence: `sources/agents/browser_agent.py`)
- General agent → Agent tools: uses tools (evidence: `sources/agents/casual_agent.py`)
- File agent → Agent tools: uses tools (evidence: `sources/agents/file_agent.py`)
- Agent base → Conversation memory: reads and updates (evidence: `sources/agents/agent.py`)
- Agent base → LLM provider: requests completion
- Task planner → Agent base: inherits from (evidence: `sources/agents/planner_agent.py`)
- Interaction → Speech input: captures speech (evidence: `sources/interaction.py`)
- Interaction → Speech output: speaks response (evidence: `sources/interaction.py`)
- Query API → Workspace files: uses workspace (evidence: `api.py`)
- LLM provider → Local LLM server: requests generation
