# suink/diana architecture

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

- Interactive diagram: https://gitdiagram.com/suink/diana
- Repository: https://github.com/suink/diana

## Overview

Diana is a self-hosted, multi-platform chat agent with a browser-based administration console. The principal workflow is an incoming platform message, assistant processing with an LLM and optional built-in capabilities, then a reply routed back through the originating platform. The README documents platform, LLM, local SQLite, and console roles; source excerpts are limited, so detailed backend call ownership and subsystem wiring are not asserted. The graph preserves documented feature branches and the sampled console API and storage-usage path.

Main entry points: [`model/assistant/runtime.go`](https://github.com/suink/diana/blob/main/model/assistant/runtime.go) (Assistant runtime), [`model/assistant/platforms.go`](https://github.com/suink/diana/blob/main/model/assistant/platforms.go) (Chat platforms), [`frontend-next/src/api.ts`](https://github.com/suink/diana/blob/main/frontend-next/src/api.ts) (Console API client), [`webui/storage_usage.go`](https://github.com/suink/diana/blob/main/webui/storage_usage.go) (Web API handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversation["Conversation runtime"]
  node_platforms["Chat platforms<br/>[platforms.go]"]
  node_assistant["Assistant runtime<br/>[runtime.go]"]
  node_reply["Reply delivery"]
  node_llm["LLM providers<br/>[types.go]"]
end

subgraph group_capabilities["Agent capabilities"]
  node_search["Web search<br/>[web_search.go]"]
  node_memory["Long-term memory<br/>[memory_runtime.go]"]
  node_media["Media and files<br/>[local_media.go]"]
  node_music["Music delivery<br/>[music_plugin.go]"]
  node_stickers["Sticker replies<br/>[sticker_plugin.go]"]
  node_ocr["Document OCR<br/>[document_ocr.go]"]
  node_browser["Browser control<br/>[manager.go]"]
end

subgraph group_console["Web console"]
  node_webui["Web console<br/>[App.vue]"]
  node_views["Console views<br/>[SettingsView.vue]"]
  node_api["Console API client<br/>[api.ts]"]
  node_storage_view["Storage usage view<br/>[StorageDonut.vue]"]
  node_http_api["Web API handlers<br/>[storage_usage.go]"]
end

subgraph group_persistence["Local persistence"]
  node_sqlite[("Local SQLite data")]
end

subgraph group_operations["Service operations"]
  node_maintenance["Storage maintenance"]
  node_service["Diana service<br/>[main.go]"]
end

node_person(("Chat participant"))
node_admin(("Administrator"))

node_person -->|"sends message"| node_platforms
node_platforms -->|"delivers event"| node_assistant
node_assistant -->|"uses model"| node_llm
node_assistant -.->|"forms reply"| node_reply
node_reply -->|"sends response"| node_platforms
node_assistant -->|"can search"| node_search
node_assistant -->|"uses memory"| node_memory
node_assistant -->|"parses files"| node_media
node_assistant -->|"can play music"| node_music
node_assistant -->|"can send stickers"| node_stickers
node_assistant -->|"can OCR"| node_ocr
node_assistant -.->|"can control browser"| node_browser
node_admin -->|"manages service"| node_webui
node_webui -->|"shows console pages"| node_views
node_views -.->|"requests data"| node_api
node_api -.->|"calls endpoints"| node_http_api
node_admin -->|"requests storage usage"| node_http_api
node_http_api -.->|"returns usage data"| node_storage_view
node_storage_view -->|"formats usage"| node_api
node_assistant -->|"stores local data"| node_sqlite
node_maintenance -->|"prunes records"| node_sqlite
node_service -.->|"runs maintenance"| node_maintenance

click node_platforms "https://github.com/suink/diana/blob/main/model/assistant/platforms.go"
click node_assistant "https://github.com/suink/diana/blob/main/model/assistant/runtime.go"
click node_reply "https://github.com/suink/diana/blob/main/model/assistant/runtime_outbound.go"
click node_llm "https://github.com/suink/diana/blob/main/model/llm/types.go"
click node_search "https://github.com/suink/diana/blob/main/model/agent/web_search.go"
click node_memory "https://github.com/suink/diana/blob/main/model/assistant/memory_runtime.go"
click node_media "https://github.com/suink/diana/blob/main/model/assistant/local_media.go"
click node_music "https://github.com/suink/diana/blob/main/model/assistant/music_plugin.go"
click node_stickers "https://github.com/suink/diana/blob/main/model/assistant/sticker_plugin.go"
click node_ocr "https://github.com/suink/diana/blob/main/model/assistant/document_ocr.go"
click node_browser "https://github.com/suink/diana/blob/main/model/browserbox/manager.go"
click node_webui "https://github.com/suink/diana/blob/main/frontend-next/src/App.vue"
click node_views "https://github.com/suink/diana/blob/main/frontend-next/src/views/SettingsView.vue"
click node_api "https://github.com/suink/diana/blob/main/frontend-next/src/api.ts"
click node_storage_view "https://github.com/suink/diana/blob/main/frontend-next/src/components/StorageDonut.vue"
click node_http_api "https://github.com/suink/diana/blob/main/webui/storage_usage.go"
click node_maintenance "https://github.com/suink/diana/blob/main/cmd/webui/storage_maintenance.go"
click node_service "https://github.com/suink/diana/blob/main/cmd/webui/main.go"

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_platforms,node_assistant,node_reply,node_llm toneBlue
class node_search,node_memory,node_media,node_music,node_stickers,node_ocr,node_browser toneAmber
class node_webui,node_views,node_api,node_storage_view,node_http_api toneMint
class node_sqlite toneRose
class node_maintenance,node_service,node_person,node_admin toneIndigo
```

## Components

### Conversation runtime

- [Chat platforms](https://github.com/suink/diana/blob/main/model/assistant/platforms.go): `model/assistant/platforms.go`
- [Assistant runtime](https://github.com/suink/diana/blob/main/model/assistant/runtime.go): `model/assistant/runtime.go`
- [Reply delivery](https://github.com/suink/diana/blob/main/model/assistant/runtime_outbound.go): `model/assistant/runtime_outbound.go`
- [LLM providers](https://github.com/suink/diana/blob/main/model/llm/types.go): `model/llm/types.go`

### Agent capabilities

- [Web search](https://github.com/suink/diana/blob/main/model/agent/web_search.go): `model/agent/web_search.go`
- [Long-term memory](https://github.com/suink/diana/blob/main/model/assistant/memory_runtime.go): `model/assistant/memory_runtime.go`
- [Media and files](https://github.com/suink/diana/blob/main/model/assistant/local_media.go): `model/assistant/local_media.go`
- [Music delivery](https://github.com/suink/diana/blob/main/model/assistant/music_plugin.go): `model/assistant/music_plugin.go`
- [Sticker replies](https://github.com/suink/diana/blob/main/model/assistant/sticker_plugin.go): `model/assistant/sticker_plugin.go`
- [Document OCR](https://github.com/suink/diana/blob/main/model/assistant/document_ocr.go): `model/assistant/document_ocr.go`
- [Browser control](https://github.com/suink/diana/blob/main/model/browserbox/manager.go): `model/browserbox/manager.go`

### Web console

- [Web console](https://github.com/suink/diana/blob/main/frontend-next/src/App.vue): `frontend-next/src/App.vue`
- [Console views](https://github.com/suink/diana/blob/main/frontend-next/src/views/SettingsView.vue): `frontend-next/src/views/SettingsView.vue`
- [Console API client](https://github.com/suink/diana/blob/main/frontend-next/src/api.ts): `frontend-next/src/api.ts`
- [Storage usage view](https://github.com/suink/diana/blob/main/frontend-next/src/components/StorageDonut.vue): `frontend-next/src/components/StorageDonut.vue`
- [Web API handlers](https://github.com/suink/diana/blob/main/webui/storage_usage.go): `webui/storage_usage.go`

### Local persistence

- **Local SQLite data**

### Service operations

- [Storage maintenance](https://github.com/suink/diana/blob/main/cmd/webui/storage_maintenance.go): `cmd/webui/storage_maintenance.go`
- [Diana service](https://github.com/suink/diana/blob/main/cmd/webui/main.go): `cmd/webui/main.go`

### Other components

- **Chat participant**
- **Administrator**

## Connections

- Chat participant → Chat platforms: sends message (evidence: `README.md`)
- Chat platforms → Assistant runtime: delivers event (evidence: `README.md`)
- Assistant runtime → LLM providers: uses model (evidence: `README.md`)
- Assistant runtime → Reply delivery: forms reply
- Reply delivery → Chat platforms: sends response (evidence: `README.md`)
- Assistant runtime → Web search: can search (evidence: `README.md`)
- Assistant runtime → Long-term memory: uses memory (evidence: `README.md`)
- Assistant runtime → Media and files: parses files (evidence: `README.md`)
- Assistant runtime → Music delivery: can play music (evidence: `README.md`)
- Assistant runtime → Sticker replies: can send stickers (evidence: `README.md`)
- Assistant runtime → Document OCR: can OCR (evidence: `README.md`)
- Assistant runtime → Browser control: can control browser
- Administrator → Web console: manages service (evidence: `README.md`)
- Web console → Console views: shows console pages (evidence: `frontend-next/src/App.vue`)
- Console views → Console API client: requests data
- Console API client → Web API handlers: calls endpoints
- Administrator → Web API handlers: requests storage usage (evidence: `webui/storage_usage.go`)
- Web API handlers → Storage usage view: returns usage data
- Storage usage view → Console API client: formats usage
- Assistant runtime → Local SQLite data: stores local data (evidence: `README.md`)
- Storage maintenance → Local SQLite data: prunes records (evidence: `cmd/webui/storage_maintenance.go`)
- Diana service → Storage maintenance: runs maintenance
