# erriswheel/jarvis architecture

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

- Interactive diagram: https://gitdiagram.com/erriswheel/jarvis
- Repository: https://github.com/erriswheel/jarvis

## Overview

J.A.R.V.I.S. is a local-first personal AI workspace. The operator uses the React dashboard to send requests to a loopback FastAPI service; chat is handled with local Ollama, with conversation and memory data persisted in SQLite. Separate capabilities cover voice, document import, learning, model-team review, telemetry, and workspace operations. The README documents these capabilities; some current modules were not sampled, so their internal call relationships are left out rather than inferred.

Main entry points: [`backend/app/main.py`](https://github.com/erriswheel/jarvis/blob/main/backend/app/main.py) (FastAPI service), [`frontend/src/App.tsx`](https://github.com/erriswheel/jarvis/blob/main/frontend/src/App.tsx) (Dashboard UI), [`frontend/src/api.ts`](https://github.com/erriswheel/jarvis/blob/main/frontend/src/api.ts) (API client), [`backend/app/database.py`](https://github.com/erriswheel/jarvis/blob/main/backend/app/database.py) (Conversation store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard"]
  node_dashboard["Dashboard UI<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_hologram["3D hologram<br/>[Hologram.tsx]"]
  node_development_lab["Development lab<br/>[DevelopmentLab.tsx]"]
  node_operations_panel["Operations panel"]
end

subgraph group_conversation["Assistant workflow"]
  node_api_service["FastAPI service<br/>[main.py]"]
  node_task_router["Task routing<br/>[task_router.py]"]
  node_model_team["Model team<br/>[model_team.py]"]
  node_learning_modes["Learning modes<br/>[learning.py]"]
  node_instructions["Operator instructions"]
end

subgraph group_knowledge["Memory and files"]
  node_conversation_store[("Conversation store<br/>[database.py]")]
  node_memory_manager[("Memory manager<br/>[database.py]")]
  node_memory_vectors["Memory vectors<br/>[memory_vectors.py]"]
  node_document_import["Document import<br/>[documents.py]"]
  node_file_exports["File exports<br/>[file_exports.py]"]
end

subgraph group_voice["Voice and telemetry"]
  node_voice_listener["Voice listener<br/>[voice_listener.py]"]
  node_speech["Speech<br/>[speech.py]"]
  node_monitor["Hardware telemetry<br/>[monitor.py]"]
end

subgraph group_workspace["Workspace operations"]
  node_workspace_store[("Workspace metadata<br/>[platform_store.py]")]
  node_security["Local security<br/>[security.py]"]
  node_backup_manager["Backup manager<br/>[backup_manager.py]"]
  node_self_development["Self development"]
  node_poster_reference["Poster references"]
  node_config["Runtime configuration<br/>[config.py]"]
end

node_operator(("Operator"))
node_ollama["Local Ollama"]

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"calls"| node_api_client
node_api_client -->|"sends requests"| node_api_service
node_api_service -->|"requests inference"| node_ollama
node_api_service -->|"checks models"| node_ollama
node_api_service -.-> node_task_router
node_api_service -.-> node_model_team
node_api_service -.-> node_learning_modes
node_api_service -.-> node_instructions
node_api_service -->|"persists history"| node_conversation_store
node_api_service -->|"manages memories"| node_memory_manager
node_api_service -.-> node_memory_vectors
node_api_service -->|"imports documents"| node_document_import
node_api_service -.-> node_file_exports
node_api_service -->|"uses wake listener"| node_voice_listener
node_api_service -->|"produces speech"| node_speech
node_api_service -->|"reads telemetry"| node_monitor
node_api_service -.-> node_workspace_store
node_api_service -->|"enforces local boundary"| node_security
node_api_service -.-> node_backup_manager
node_api_service -.-> node_self_development
node_api_service -.-> node_poster_reference
node_api_service -.-> node_config
node_dashboard -->|"renders"| node_hologram
node_dashboard -->|"renders"| node_development_lab
node_dashboard -->|"renders"| node_operations_panel
node_conversation_store -.-> node_memory_manager

click node_dashboard "https://github.com/erriswheel/jarvis/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/erriswheel/jarvis/blob/main/frontend/src/api.ts"
click node_hologram "https://github.com/erriswheel/jarvis/blob/main/frontend/src/Hologram.tsx"
click node_development_lab "https://github.com/erriswheel/jarvis/blob/main/frontend/src/DevelopmentLab.tsx"
click node_operations_panel "https://github.com/erriswheel/jarvis/blob/main/frontend/src/OperationsPanel.tsx"
click node_api_service "https://github.com/erriswheel/jarvis/blob/main/backend/app/main.py"
click node_task_router "https://github.com/erriswheel/jarvis/blob/main/backend/app/task_router.py"
click node_model_team "https://github.com/erriswheel/jarvis/blob/main/backend/app/model_team.py"
click node_learning_modes "https://github.com/erriswheel/jarvis/blob/main/backend/app/learning.py"
click node_instructions "https://github.com/erriswheel/jarvis/blob/main/backend/app/operator_instructions.py"
click node_conversation_store "https://github.com/erriswheel/jarvis/blob/main/backend/app/database.py"
click node_memory_manager "https://github.com/erriswheel/jarvis/blob/main/backend/app/database.py"
click node_memory_vectors "https://github.com/erriswheel/jarvis/blob/main/backend/app/memory_vectors.py"
click node_document_import "https://github.com/erriswheel/jarvis/blob/main/backend/app/documents.py"
click node_file_exports "https://github.com/erriswheel/jarvis/blob/main/backend/app/file_exports.py"
click node_voice_listener "https://github.com/erriswheel/jarvis/blob/main/backend/app/voice_listener.py"
click node_speech "https://github.com/erriswheel/jarvis/blob/main/backend/app/speech.py"
click node_monitor "https://github.com/erriswheel/jarvis/blob/main/backend/app/monitor.py"
click node_workspace_store "https://github.com/erriswheel/jarvis/blob/main/backend/app/platform_store.py"
click node_security "https://github.com/erriswheel/jarvis/blob/main/backend/app/security.py"
click node_backup_manager "https://github.com/erriswheel/jarvis/blob/main/backend/app/backup_manager.py"
click node_self_development "https://github.com/erriswheel/jarvis/blob/main/backend/app/self_development.py"
click node_poster_reference "https://github.com/erriswheel/jarvis/blob/main/backend/app/poster_reference.py"
click node_config "https://github.com/erriswheel/jarvis/blob/main/backend/app/config.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_dashboard,node_api_client,node_hologram,node_development_lab,node_operations_panel toneBlue
class node_api_service,node_task_router,node_model_team,node_learning_modes,node_instructions toneAmber
class node_conversation_store,node_memory_manager,node_memory_vectors,node_document_import,node_file_exports toneMint
class node_voice_listener,node_speech,node_monitor toneRose
class node_workspace_store,node_security,node_backup_manager,node_self_development,node_poster_reference,node_config,node_operator,node_ollama toneIndigo
```

## Components

### Dashboard

- [Dashboard UI](https://github.com/erriswheel/jarvis/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/erriswheel/jarvis/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [3D hologram](https://github.com/erriswheel/jarvis/blob/main/frontend/src/Hologram.tsx): `frontend/src/Hologram.tsx`
- [Development lab](https://github.com/erriswheel/jarvis/blob/main/frontend/src/DevelopmentLab.tsx): `frontend/src/DevelopmentLab.tsx`
- [Operations panel](https://github.com/erriswheel/jarvis/blob/main/frontend/src/OperationsPanel.tsx): `frontend/src/OperationsPanel.tsx`

### Assistant workflow

- [FastAPI service](https://github.com/erriswheel/jarvis/blob/main/backend/app/main.py): `backend/app/main.py`
- [Task routing](https://github.com/erriswheel/jarvis/blob/main/backend/app/task_router.py): `backend/app/task_router.py`
- [Model team](https://github.com/erriswheel/jarvis/blob/main/backend/app/model_team.py): `backend/app/model_team.py`
- [Learning modes](https://github.com/erriswheel/jarvis/blob/main/backend/app/learning.py): `backend/app/learning.py`
- [Operator instructions](https://github.com/erriswheel/jarvis/blob/main/backend/app/operator_instructions.py): `backend/app/operator_instructions.py`

### Memory and files

- [Conversation store](https://github.com/erriswheel/jarvis/blob/main/backend/app/database.py): `backend/app/database.py`
- [Memory manager](https://github.com/erriswheel/jarvis/blob/main/backend/app/database.py): `backend/app/database.py`
- [Memory vectors](https://github.com/erriswheel/jarvis/blob/main/backend/app/memory_vectors.py): `backend/app/memory_vectors.py`
- [Document import](https://github.com/erriswheel/jarvis/blob/main/backend/app/documents.py): `backend/app/documents.py`
- [File exports](https://github.com/erriswheel/jarvis/blob/main/backend/app/file_exports.py): `backend/app/file_exports.py`

### Voice and telemetry

- [Voice listener](https://github.com/erriswheel/jarvis/blob/main/backend/app/voice_listener.py): `backend/app/voice_listener.py`
- [Speech](https://github.com/erriswheel/jarvis/blob/main/backend/app/speech.py): `backend/app/speech.py`
- [Hardware telemetry](https://github.com/erriswheel/jarvis/blob/main/backend/app/monitor.py): `backend/app/monitor.py`

### Workspace operations

- [Workspace metadata](https://github.com/erriswheel/jarvis/blob/main/backend/app/platform_store.py): `backend/app/platform_store.py`
- [Local security](https://github.com/erriswheel/jarvis/blob/main/backend/app/security.py): `backend/app/security.py`
- [Backup manager](https://github.com/erriswheel/jarvis/blob/main/backend/app/backup_manager.py): `backend/app/backup_manager.py`
- [Self development](https://github.com/erriswheel/jarvis/blob/main/backend/app/self_development.py): `backend/app/self_development.py`
- [Poster references](https://github.com/erriswheel/jarvis/blob/main/backend/app/poster_reference.py): `backend/app/poster_reference.py`
- [Runtime configuration](https://github.com/erriswheel/jarvis/blob/main/backend/app/config.py): `backend/app/config.py`

### Other components

- **Operator**
- **Local Ollama**

## Connections

- Operator → Dashboard UI: uses (evidence: `README.md`)
- Dashboard UI → API client: calls (evidence: `frontend/src/App.tsx`)
- API client → FastAPI service: sends requests (evidence: `README.md`)
- FastAPI service → Local Ollama: requests inference (evidence: `README.md`)
- FastAPI service → Local Ollama: checks models (evidence: `backend/app/main.py`)
- FastAPI service → Task routing (evidence: `backend/app/main.py`)
- FastAPI service → Model team (evidence: `backend/app/main.py`)
- FastAPI service → Learning modes (evidence: `backend/app/main.py`)
- FastAPI service → Operator instructions (evidence: `backend/app/main.py`)
- FastAPI service → Conversation store: persists history (evidence: `README.md`)
- FastAPI service → Memory manager: manages memories (evidence: `README.md`)
- FastAPI service → Memory vectors (evidence: `backend/app/main.py`)
- FastAPI service → Document import: imports documents (evidence: `README.md`)
- FastAPI service → File exports (evidence: `backend/app/main.py`)
- FastAPI service → Voice listener: uses wake listener (evidence: `README.md`)
- FastAPI service → Speech: produces speech (evidence: `README.md`)
- FastAPI service → Hardware telemetry: reads telemetry (evidence: `README.md`)
- FastAPI service → Workspace metadata (evidence: `backend/app/main.py`)
- FastAPI service → Local security: enforces local boundary (evidence: `README.md`)
- FastAPI service → Backup manager (evidence: `backend/app/main.py`)
- FastAPI service → Self development (evidence: `backend/app/main.py`)
- FastAPI service → Poster references (evidence: `backend/app/main.py`)
- FastAPI service → Runtime configuration (evidence: `backend/app/main.py`)
- Dashboard UI → 3D hologram: renders (evidence: `frontend/src/App.tsx`)
- Dashboard UI → Development lab: renders (evidence: `frontend/src/App.tsx`)
- Dashboard UI → Operations panel: renders (evidence: `frontend/src/App.tsx`)
- Conversation store → Memory manager (evidence: `backend/app/database.py`)
