# natebassett/mavis architecture

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

- Interactive diagram: https://gitdiagram.com/natebassett/mavis
- Repository: https://github.com/natebassett/mavis

## Overview

MAVIS currently runs as a minimal text-console assistant: input reaches an orchestrator that logs it and returns an echo (or an empty-input prompt). Intent routing, message-bus messaging, and persistent/semantic memory exist as separate modules, but the sampled orchestrator does not invoke them. Voice, skills, desktop control, and online/offline intelligence are README goals, not implemented components in the shown tree. Edges reflect sampled calls or SOURCE INDEX references; those references do not establish a connection from the orchestrator to the intent or memory subsystems.

Main entry points: [`app/core/orchestrator.py`](https://github.com/natebassett/mavis/blob/development/app/core/orchestrator.py) (Orchestrator), [`app/memory/database.py`](https://github.com/natebassett/mavis/blob/development/app/memory/database.py) (Database access), [`main.py`](https://github.com/natebassett/mavis/blob/development/main.py) (Console loop), [`app/utils/logger.py`](https://github.com/natebassett/mavis/blob/development/app/utils/logger.py) (Logger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Console interaction"]
  node_console["Console loop<br/>[main.py]"]
end

subgraph group_coordination["Core coordination"]
  node_orchestrator["Orchestrator<br/>[orchestrator.py]"]
  node_logger["Logger<br/>[logger.py]"]
  node_config["Configuration<br/>[config_manager.py]"]
  node_message_bus["Message bus<br/>[message_bus.py]"]
  node_agent_message["Agent message<br/>[agent_message.py]"]
end

subgraph group_memory["Intent and memory"]
  node_intent_router["Intent router<br/>[intent_router.py]"]
  node_intent_types["Intent types<br/>[intent_types.py]"]
  node_memory_manager["Memory manager<br/>[memory_manager.py]"]
  node_semantic_search["Semantic search<br/>[semantic_search.py]"]
  node_database["Database access<br/>[database.py]"]
  node_sqlite[("SQLite database")]
end

node_user(("User"))

node_user -->|"enters input"| node_console
node_console -->|"processes input"| node_orchestrator
node_orchestrator -->|"returns response"| node_console
node_orchestrator -->|"logs input"| node_logger
node_logger -->|"reads log level"| node_config
node_message_bus -->|"stores messages"| node_agent_message
node_message_bus -->|"logs dispatch"| node_logger
node_intent_router -->|"selects intent"| node_intent_types
node_memory_manager -->|"reads and writes"| node_database
node_memory_manager -->|"embeds and scores"| node_semantic_search
node_database -->|"reads database path"| node_config
node_database -->|"opens and initializes"| node_sqlite

click node_console "https://github.com/natebassett/mavis/blob/development/main.py"
click node_orchestrator "https://github.com/natebassett/mavis/blob/development/app/core/orchestrator.py"
click node_logger "https://github.com/natebassett/mavis/blob/development/app/utils/logger.py"
click node_config "https://github.com/natebassett/mavis/blob/development/app/config/config_manager.py"
click node_message_bus "https://github.com/natebassett/mavis/blob/development/app/core/message_bus.py"
click node_agent_message "https://github.com/natebassett/mavis/blob/development/app/core/agent_message.py"
click node_intent_router "https://github.com/natebassett/mavis/blob/development/app/intent/intent_router.py"
click node_intent_types "https://github.com/natebassett/mavis/blob/development/app/intent/intent_types.py"
click node_memory_manager "https://github.com/natebassett/mavis/blob/development/app/memory/memory_manager.py"
click node_semantic_search "https://github.com/natebassett/mavis/blob/development/app/memory/semantic_search.py"
click node_database "https://github.com/natebassett/mavis/blob/development/app/memory/database.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_console,node_user toneBlue
class node_orchestrator,node_logger,node_config,node_message_bus,node_agent_message toneAmber
class node_intent_router,node_intent_types,node_memory_manager,node_semantic_search,node_database,node_sqlite toneMint
```

## Components

### Console interaction

- [Console loop](https://github.com/natebassett/mavis/blob/development/main.py): `main.py`

### Core coordination

- [Orchestrator](https://github.com/natebassett/mavis/blob/development/app/core/orchestrator.py): `app/core/orchestrator.py`
- [Logger](https://github.com/natebassett/mavis/blob/development/app/utils/logger.py): `app/utils/logger.py`
- [Configuration](https://github.com/natebassett/mavis/blob/development/app/config/config_manager.py): `app/config/config_manager.py`
- [Message bus](https://github.com/natebassett/mavis/blob/development/app/core/message_bus.py): `app/core/message_bus.py`
- [Agent message](https://github.com/natebassett/mavis/blob/development/app/core/agent_message.py): `app/core/agent_message.py`

### Intent and memory

- [Intent router](https://github.com/natebassett/mavis/blob/development/app/intent/intent_router.py): `app/intent/intent_router.py`
- [Intent types](https://github.com/natebassett/mavis/blob/development/app/intent/intent_types.py): `app/intent/intent_types.py`
- [Memory manager](https://github.com/natebassett/mavis/blob/development/app/memory/memory_manager.py): `app/memory/memory_manager.py`
- [Semantic search](https://github.com/natebassett/mavis/blob/development/app/memory/semantic_search.py): `app/memory/semantic_search.py`
- [Database access](https://github.com/natebassett/mavis/blob/development/app/memory/database.py): `app/memory/database.py`
- **SQLite database**

### Other components

- **User**

## Connections

- User → Console loop: enters input (evidence: `main.py`)
- Console loop → Orchestrator: processes input (evidence: `main.py`)
- Orchestrator → Console loop: returns response (evidence: `main.py`)
- Orchestrator → Logger: logs input (evidence: `app/core/orchestrator.py`)
- Logger → Configuration: reads log level (evidence: `app/utils/logger.py`)
- Message bus → Agent message: stores messages (evidence: `app/core/message_bus.py`)
- Message bus → Logger: logs dispatch (evidence: `app/core/message_bus.py`)
- Intent router → Intent types: selects intent (evidence: `app/intent/intent_router.py`)
- Memory manager → Database access: reads and writes (evidence: `app/memory/memory_manager.py`)
- Memory manager → Semantic search: embeds and scores (evidence: `app/memory/memory_manager.py`)
- Database access → Configuration: reads database path (evidence: `app/memory/database.py`)
- Database access → SQLite database: opens and initializes (evidence: `app/memory/database.py`)
