# enowdev/antares architecture

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

- Interactive diagram: https://gitdiagram.com/enowdev/antares
- Repository: https://github.com/enowdev/antares

## Overview

Antares is a self-hosted AI assistant and authorized penetration-testing workspace, delivered through a Go server, dashboard, terminal UI, and desktop shell. The main workflow is a user request entering through the server or gateway, being handled by the agent with model and tool capabilities, and producing streamed responses or persisted work. Separate capabilities include security testing and reporting, content creation, memory/RAG, scheduling, and integrations. The README and source index establish major subsystems; some internal links remain unverified because their implementations were not sampled.

Main entry points: [`cmd/antares/main.go`](https://github.com/enowdev/antares/blob/main/cmd/antares/main.go) (CLI and TUI), [`internal/agent/agent.go`](https://github.com/enowdev/antares/blob/main/internal/agent/agent.go) (Agent runtime), [`internal/agent/ragcontext.go`](https://github.com/enowdev/antares/blob/main/internal/agent/ragcontext.go) (Turn memory), [`internal/engagement`](https://github.com/enowdev/antares/tree/main/internal/engagement) (Security testing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Interfaces"]
  node_cli["CLI and TUI<br/>[main.go]"]
  node_dashboard["Web dashboard<br/>[App.tsx]"]
  node_chatstream["Chat streaming"]
  node_http["HTTP server<br/>[server.go]"]
  node_creatorui["Pipeline UI<br/>[parts.tsx]"]
  node_desktop["Desktop shell<br/>[manager.go]"]
  node_desktopui["Desktop connection UI<br/>[app.js]"]
  node_desktopbridge["Desktop bridge<br/>[bridge.js]"]
  node_desktopdemo["Desktop demo mode<br/>[demo.js]"]
end

subgraph group_runtime["Agent runtime"]
  node_agent["Agent runtime<br/>[agent.go]"]
  node_models["Model clients<br/>[client.go]"]
  node_tools["Agent tools<br/>[register.go]"]
  node_browser["Browser control<br/>[session.go]"]
  node_ragcontext["Turn memory<br/>[ragcontext.go]"]
end

subgraph group_security["Security work"]
  node_pentest["Security testing"]
  node_findings["Findings and reports<br/>[findings.go]"]
  node_hookpack["Test procedures<br/>[hookpack.go]"]
end

subgraph group_workspace["Workspace capabilities"]
  node_rag[("RAG index<br/>[rag.go]")]
  node_store[("Persistent state<br/>[sql.go]")]
  node_creator["Content pipeline<br/>[service.go]"]
  node_migration["Import migration<br/>[common.go]"]
end

subgraph group_integrations["Services and integrations"]
  node_scheduler["Scheduled work<br/>[runner.go]"]
  node_gateways["Messaging gateways<br/>[gateway.go]"]
  node_mcp["MCP connections<br/>[client.go]"]
  node_commands["Command dispatch<br/>[handlers.go]"]
end

node_user(("User"))

node_user -->|"invokes"| node_cli
node_user -->|"uses"| node_dashboard
node_dashboard -->|"streams chat"| node_chatstream
node_cli -->|"runs"| node_agent
node_cli -->|"starts"| node_http
node_http -->|"serves requests"| node_agent
node_agent -->|"requests completions"| node_models
node_agent -.->|"builds turn context"| node_ragcontext
node_ragcontext -->|"indexes and retrieves"| node_rag
node_ragcontext -->|"reads state"| node_store
node_agent -.->|"uses tools"| node_tools
node_tools -.->|"drives browser"| node_browser
node_user -->|"authorizes testing"| node_pentest
node_pentest -->|"records findings"| node_findings
node_pentest -->|"uses procedures"| node_hookpack
node_user -->|"runs stages"| node_creatorui
node_creatorui -.->|"starts pipeline"| node_creator
node_cli -->|"prepares creator runs"| node_creator
node_cli -->|"starts scheduler"| node_scheduler
node_cli -->|"starts gateways"| node_gateways
node_cli -->|"initializes MCP"| node_mcp
node_cli -->|"routes gateway commands"| node_commands
node_user -.->|"imports prior data"| node_migration
node_desktopui -->|"calls bridge"| node_desktopbridge
node_desktopbridge -.->|"invokes shell"| node_desktop
node_desktopdemo -->|"provides demo calls"| node_desktopbridge
node_desktop -.->|"connects dashboard"| node_http

click node_cli "https://github.com/enowdev/antares/blob/main/cmd/antares/main.go"
click node_dashboard "https://github.com/enowdev/antares/blob/main/web/src/App.tsx"
click node_chatstream "https://github.com/enowdev/antares/blob/main/web/src/lib/chatStreamController.ts"
click node_http "https://github.com/enowdev/antares/blob/main/internal/server/server.go"
click node_agent "https://github.com/enowdev/antares/blob/main/internal/agent/agent.go"
click node_models "https://github.com/enowdev/antares/blob/main/internal/llm/client.go"
click node_tools "https://github.com/enowdev/antares/blob/main/internal/tools/register.go"
click node_browser "https://github.com/enowdev/antares/blob/main/internal/browser/session.go"
click node_ragcontext "https://github.com/enowdev/antares/blob/main/internal/agent/ragcontext.go"
click node_rag "https://github.com/enowdev/antares/blob/main/internal/rag/rag.go"
click node_store "https://github.com/enowdev/antares/blob/main/internal/store/sql.go"
click node_pentest "https://github.com/enowdev/antares/tree/main/internal/engagement"
click node_findings "https://github.com/enowdev/antares/blob/main/internal/findings/findings.go"
click node_hookpack "https://github.com/enowdev/antares/blob/main/internal/hookpack/hookpack.go"
click node_creator "https://github.com/enowdev/antares/blob/main/internal/creator/service.go"
click node_creatorui "https://github.com/enowdev/antares/blob/main/web/src/components/creator/parts.tsx"
click node_scheduler "https://github.com/enowdev/antares/blob/main/internal/cron/runner.go"
click node_gateways "https://github.com/enowdev/antares/blob/main/internal/gateway/gateway.go"
click node_mcp "https://github.com/enowdev/antares/blob/main/internal/mcp/client.go"
click node_commands "https://github.com/enowdev/antares/blob/main/internal/commands/handlers.go"
click node_migration "https://github.com/enowdev/antares/blob/main/internal/migrate/common.go"
click node_desktop "https://github.com/enowdev/antares/blob/main/desktop/internal/core/manager.go"
click node_desktopui "https://github.com/enowdev/antares/blob/main/desktop/frontend/app.js"
click node_desktopbridge "https://github.com/enowdev/antares/blob/main/desktop/frontend/bridge.js"
click node_desktopdemo "https://github.com/enowdev/antares/blob/main/desktop/frontend/demo.js"

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_cli,node_dashboard,node_chatstream,node_http,node_creatorui,node_desktop,node_desktopui,node_desktopbridge,node_desktopdemo,node_user toneBlue
class node_agent,node_models,node_tools,node_browser,node_ragcontext toneAmber
class node_pentest,node_findings,node_hookpack toneMint
class node_rag,node_store,node_creator,node_migration toneRose
class node_scheduler,node_gateways,node_mcp,node_commands toneIndigo
```

## Components

### Interfaces

- [CLI and TUI](https://github.com/enowdev/antares/blob/main/cmd/antares/main.go): `cmd/antares/main.go`
- [Web dashboard](https://github.com/enowdev/antares/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Chat streaming](https://github.com/enowdev/antares/blob/main/web/src/lib/chatStreamController.ts): `web/src/lib/chatStreamController.ts`
- [HTTP server](https://github.com/enowdev/antares/blob/main/internal/server/server.go): `internal/server/server.go`
- [Pipeline UI](https://github.com/enowdev/antares/blob/main/web/src/components/creator/parts.tsx): `web/src/components/creator/parts.tsx`
- [Desktop shell](https://github.com/enowdev/antares/blob/main/desktop/internal/core/manager.go): `desktop/internal/core/manager.go`
- [Desktop connection UI](https://github.com/enowdev/antares/blob/main/desktop/frontend/app.js): `desktop/frontend/app.js`
- [Desktop bridge](https://github.com/enowdev/antares/blob/main/desktop/frontend/bridge.js): `desktop/frontend/bridge.js`
- [Desktop demo mode](https://github.com/enowdev/antares/blob/main/desktop/frontend/demo.js): `desktop/frontend/demo.js`

### Agent runtime

- [Agent runtime](https://github.com/enowdev/antares/blob/main/internal/agent/agent.go): `internal/agent/agent.go`
- [Model clients](https://github.com/enowdev/antares/blob/main/internal/llm/client.go): `internal/llm/client.go`
- [Agent tools](https://github.com/enowdev/antares/blob/main/internal/tools/register.go): `internal/tools/register.go`
- [Browser control](https://github.com/enowdev/antares/blob/main/internal/browser/session.go): `internal/browser/session.go`
- [Turn memory](https://github.com/enowdev/antares/blob/main/internal/agent/ragcontext.go): `internal/agent/ragcontext.go`

### Security work

- [Security testing](https://github.com/enowdev/antares/tree/main/internal/engagement): `internal/engagement`
- [Findings and reports](https://github.com/enowdev/antares/blob/main/internal/findings/findings.go): `internal/findings/findings.go`
- [Test procedures](https://github.com/enowdev/antares/blob/main/internal/hookpack/hookpack.go): `internal/hookpack/hookpack.go`

### Workspace capabilities

- [RAG index](https://github.com/enowdev/antares/blob/main/internal/rag/rag.go): `internal/rag/rag.go`
- [Persistent state](https://github.com/enowdev/antares/blob/main/internal/store/sql.go): `internal/store/sql.go`
- [Content pipeline](https://github.com/enowdev/antares/blob/main/internal/creator/service.go): `internal/creator/service.go`
- [Import migration](https://github.com/enowdev/antares/blob/main/internal/migrate/common.go): `internal/migrate/common.go`

### Services and integrations

- [Scheduled work](https://github.com/enowdev/antares/blob/main/internal/cron/runner.go): `internal/cron/runner.go`
- [Messaging gateways](https://github.com/enowdev/antares/blob/main/internal/gateway/gateway.go): `internal/gateway/gateway.go`
- [MCP connections](https://github.com/enowdev/antares/blob/main/internal/mcp/client.go): `internal/mcp/client.go`
- [Command dispatch](https://github.com/enowdev/antares/blob/main/internal/commands/handlers.go): `internal/commands/handlers.go`

### Other components

- **User**

## Connections

- User → CLI and TUI: invokes
- User → Web dashboard: uses
- Web dashboard → Chat streaming: streams chat (evidence: `web/src/App.tsx`)
- CLI and TUI → Agent runtime: runs (evidence: `cmd/antares/main.go`)
- CLI and TUI → HTTP server: starts (evidence: `cmd/antares/main.go`)
- HTTP server → Agent runtime: serves requests (evidence: `internal/server/server.go`)
- Agent runtime → Model clients: requests completions
- Agent runtime → Turn memory: builds turn context
- Turn memory → RAG index: indexes and retrieves (evidence: `internal/agent/ragcontext.go`)
- Turn memory → Persistent state: reads state (evidence: `internal/agent/ragcontext.go`)
- Agent runtime → Agent tools: uses tools
- Agent tools → Browser control: drives browser
- User → Security testing: authorizes testing
- Security testing → Findings and reports: records findings
- Security testing → Test procedures: uses procedures
- User → Pipeline UI: runs stages
- Pipeline UI → Content pipeline: starts pipeline
- CLI and TUI → Content pipeline: prepares creator runs (evidence: `cmd/antares/main.go`)
- CLI and TUI → Scheduled work: starts scheduler (evidence: `cmd/antares/main.go`)
- CLI and TUI → Messaging gateways: starts gateways (evidence: `cmd/antares/main.go`)
- CLI and TUI → MCP connections: initializes MCP (evidence: `cmd/antares/main.go`)
- CLI and TUI → Command dispatch: routes gateway commands (evidence: `cmd/antares/main.go`)
- User → Import migration: imports prior data
- Desktop connection UI → Desktop bridge: calls bridge (evidence: `desktop/frontend/app.js`)
- Desktop bridge → Desktop shell: invokes shell
- Desktop demo mode → Desktop bridge: provides demo calls (evidence: `desktop/frontend/bridge.js`)
- Desktop shell → HTTP server: connects dashboard
