# auto-atlas/atlas architecture

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

- Interactive diagram: https://gitdiagram.com/auto-atlas/atlas
- Repository: https://github.com/auto-atlas/atlas

## Overview

Atlas is presented as a private, local-first assistant whose voice loop is the front door: a user speaks, Atlas listens and responds, and it can gate tools or delegate specialist work and notify the user when it finishes. The repository also contains a substantial OpenJarvis runtime and frontend; the supplied excerpts show OpenJarvis ingestion, telemetry, workflows, and engine dispatch, but not their integration with the Atlas voice loop. README statements support the Atlas workflow links below; broader internal wiring is left out rather than inferred.

Main entry points: [`voice_llm.py`](https://github.com/auto-atlas/atlas/blob/main/voice_llm.py) (Voice loop), [`agent_bridge.py`](https://github.com/auto-atlas/atlas/blob/main/agent_bridge.py) (Agent hub), [`app/src/openjarvis/agents/morning_digest.py`](https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/agents/morning_digest.py) (Morning brief), [`eve-app/android/app/src/main/java/app/eve/push/StreamService.kt`](https://github.com/auto-atlas/atlas/blob/main/eve-app/android/app/src/main/java/app/eve/push/StreamService.kt) (Phone and watch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_voice["Voice assistant"]
  node_voice_loop["Voice loop<br/>[voice_llm.py]"]
  node_voice_transport["Voice transport"]
  node_local_engine["Local inference"]
  node_trust_gate["Trust tiers"]
end

subgraph group_actions["Tools and agents"]
  node_tools["Assistant tools<br/>[_stubs.py]"]
  node_agent_hub["Agent hub<br/>[agent_bridge.py]"]
  node_agent_fabric["Agent fabric<br/>[a2a_fabric.py]"]
  node_agent_tasks["Agent tasks<br/>[agent_tasks.py]"]
  node_result_store[("Agent results")]
  node_delivery["Async delivery<br/>[agent_delivery.py]"]
end

subgraph group_memory["Memory and integrations"]
  node_memory[("Persistent memory<br/>[store.py]")]
  node_connectors["Data connectors<br/>[pipeline.py]"]
  node_morning_brief["Morning brief<br/>[morning_digest.py]"]
end

subgraph group_surfaces["User surfaces"]
  node_web_ui["Web interface<br/>[App.tsx]"]
  node_phone_watch["Phone and watch<br/>[StreamService.kt]"]
  node_glasses["Glasses bridge<br/>[eve-link.ts]"]
end

node_user(("User"))
node_obsidian[("Obsidian wiki")]
node_specialist_agents["Specialist agents"]
node_local_hardware["Local hardware"]

node_user -->|"speaks to"| node_voice_loop
node_voice_loop -->|"runs locally on"| node_local_hardware
node_voice_loop -->|"gates risky tools"| node_trust_gate
node_voice_loop -->|"uses local tools"| node_tools
node_voice_loop -->|"hands off work"| node_agent_hub
node_agent_hub -->|"delegates work"| node_specialist_agents
node_agent_hub -.->|"tracks delegation"| node_agent_tasks
node_agent_tasks -.->|"stores results"| node_result_store
node_agent_hub -->|"notifies on completion"| node_delivery
node_voice_loop -->|"reloads session facts"| node_memory
node_connectors -->|"ingests documents"| node_memory
node_morning_brief -->|"grounds strategy"| node_obsidian
node_morning_brief -->|"delegates strategy"| node_specialist_agents
node_phone_watch -->|"streams voice"| node_voice_loop
node_phone_watch -->|"receives approvals"| node_delivery
node_glasses -->|"bridges camera and audio"| node_voice_loop
node_web_ui -.->|"offers assistant UI"| node_voice_loop

click node_voice_loop "https://github.com/auto-atlas/atlas/blob/main/voice_llm.py"
click node_voice_transport "https://github.com/auto-atlas/atlas/tree/main/app/src/openjarvis/agents"
click node_local_engine "https://github.com/auto-atlas/atlas/tree/main/app/src/openjarvis/engine"
click node_trust_gate "https://github.com/auto-atlas/atlas/tree/main/app/src/openjarvis/security"
click node_tools "https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/tools/_stubs.py"
click node_agent_hub "https://github.com/auto-atlas/atlas/blob/main/agent_bridge.py"
click node_agent_fabric "https://github.com/auto-atlas/atlas/blob/main/a2a_fabric.py"
click node_agent_tasks "https://github.com/auto-atlas/atlas/blob/main/agent_tasks.py"
click node_result_store "https://github.com/auto-atlas/atlas/blob/main/agent_result_store.py"
click node_delivery "https://github.com/auto-atlas/atlas/blob/main/agent_delivery.py"
click node_memory "https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/connectors/store.py"
click node_connectors "https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/connectors/pipeline.py"
click node_morning_brief "https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/agents/morning_digest.py"
click node_web_ui "https://github.com/auto-atlas/atlas/blob/main/app/frontend/src/App.tsx"
click node_phone_watch "https://github.com/auto-atlas/atlas/blob/main/eve-app/android/app/src/main/java/app/eve/push/StreamService.kt"
click node_glasses "https://github.com/auto-atlas/atlas/blob/main/glasses/mentra-eve/src/eve-link.ts"

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_voice_loop,node_voice_transport,node_local_engine,node_trust_gate,node_user toneBlue
class node_tools,node_agent_hub,node_agent_fabric,node_agent_tasks,node_result_store,node_delivery,node_obsidian toneAmber
class node_memory,node_connectors,node_morning_brief toneMint
class node_web_ui,node_phone_watch,node_glasses toneRose
class node_specialist_agents,node_local_hardware toneIndigo
```

## Components

### Voice assistant

- [Voice loop](https://github.com/auto-atlas/atlas/blob/main/voice_llm.py): `voice_llm.py`
- [Voice transport](https://github.com/auto-atlas/atlas/tree/main/app/src/openjarvis/agents): `app/src/openjarvis/agents`
- [Local inference](https://github.com/auto-atlas/atlas/tree/main/app/src/openjarvis/engine): `app/src/openjarvis/engine`
- [Trust tiers](https://github.com/auto-atlas/atlas/tree/main/app/src/openjarvis/security): `app/src/openjarvis/security`

### Tools and agents

- [Assistant tools](https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/tools/_stubs.py): `app/src/openjarvis/tools/_stubs.py`
- [Agent hub](https://github.com/auto-atlas/atlas/blob/main/agent_bridge.py): `agent_bridge.py`
- [Agent fabric](https://github.com/auto-atlas/atlas/blob/main/a2a_fabric.py): `a2a_fabric.py`
- [Agent tasks](https://github.com/auto-atlas/atlas/blob/main/agent_tasks.py): `agent_tasks.py`
- [Agent results](https://github.com/auto-atlas/atlas/blob/main/agent_result_store.py): `agent_result_store.py`
- [Async delivery](https://github.com/auto-atlas/atlas/blob/main/agent_delivery.py): `agent_delivery.py`

### Memory and integrations

- [Persistent memory](https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/connectors/store.py): `app/src/openjarvis/connectors/store.py`
- [Data connectors](https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/connectors/pipeline.py): `app/src/openjarvis/connectors/pipeline.py`
- [Morning brief](https://github.com/auto-atlas/atlas/blob/main/app/src/openjarvis/agents/morning_digest.py): `app/src/openjarvis/agents/morning_digest.py`

### User surfaces

- [Web interface](https://github.com/auto-atlas/atlas/blob/main/app/frontend/src/App.tsx): `app/frontend/src/App.tsx`
- [Phone and watch](https://github.com/auto-atlas/atlas/blob/main/eve-app/android/app/src/main/java/app/eve/push/StreamService.kt): `eve-app/android/app/src/main/java/app/eve/push/StreamService.kt`
- [Glasses bridge](https://github.com/auto-atlas/atlas/blob/main/glasses/mentra-eve/src/eve-link.ts): `glasses/mentra-eve/src/eve-link.ts`

### Other components

- **User**
- **Obsidian wiki**
- **Specialist agents**
- **Local hardware**

## Connections

- User → Voice loop: speaks to
- Voice loop → Local hardware: runs locally on
- Voice loop → Trust tiers: gates risky tools
- Voice loop → Assistant tools: uses local tools
- Voice loop → Agent hub: hands off work
- Agent hub → Specialist agents: delegates work
- Agent hub → Agent tasks: tracks delegation
- Agent tasks → Agent results: stores results
- Agent hub → Async delivery: notifies on completion
- Voice loop → Persistent memory: reloads session facts
- Data connectors → Persistent memory: ingests documents (evidence: `app/src/openjarvis/connectors/pipeline.py`)
- Morning brief → Obsidian wiki: grounds strategy
- Morning brief → Specialist agents: delegates strategy
- Phone and watch → Voice loop: streams voice
- Phone and watch → Async delivery: receives approvals
- Glasses bridge → Voice loop: bridges camera and audio
- Web interface → Voice loop: offers assistant UI
