# xtremislv/myai architecture

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

- Interactive diagram: https://gitdiagram.com/xtremislv/myai
- Repository: https://github.com/xtremislv/myai

## Overview

AI Platform is a self-hosted AI service for authenticated chat and governed department agents, backed by a local vLLM endpoint. A chat request is authenticated, handled as private chat or routed through the Request Manager, then executed by an agent graph; critical tool actions can pause for approval. Other product branches provide policy-managed object storage, encrypted secrets and user chat keys, department configuration, and operational telemetry. Edges reflect README statements and source-index references; unsampled implementation details are not inferred.

Main entry points: [`app/request_manager/router.py`](https://github.com/xtremislv/myai/blob/main/app/request_manager/router.py) (Request Manager), [`app/api/routes_chat.py`](https://github.com/xtremislv/myai/blob/main/app/api/routes_chat.py) (Chat route), [`app/acl/engine.py`](https://github.com/xtremislv/myai/blob/main/app/acl/engine.py) (ACL engine), [`app/main.py`](https://github.com/xtremislv/myai/blob/main/app/main.py) (FastAPI app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_api["FastAPI app<br/>[main.py]"]
  node_authroutes["Auth routes<br/>[routes_auth.py]"]
  node_chatroute["Chat route<br/>[routes_chat.py]"]
  node_deps["Auth dependencies<br/>[deps.py]"]
  node_security["JWT security<br/>[security.py]"]
end

subgraph group_governance["Request governance"]
  node_rm["Request Manager<br/>[router.py]"]
  node_classifier["Department classifier<br/>[classifier.py]"]
  node_approvals["Approval store<br/>[approvals.py]"]
  node_dept["Department packs<br/>[packs.py]"]
end

subgraph group_agents["Agent execution"]
  node_execution["Graph execution<br/>[execution.py]"]
  node_graphs["Agent graphs<br/>[graph.py]"]
  node_agents["Agent nodes<br/>[agents.py]"]
  node_tools["Agent tools<br/>[tools.py]"]
  node_llm["LLM client<br/>[client.py]"]
end

subgraph group_data["Data protection"]
  node_acl["ACL engine<br/>[engine.py]"]
  node_objects["Object storage<br/>[objects.py]"]
  node_vault["Encrypted vault<br/>[aesgcm_vault.py]"]
  node_userkeys["User chat keys<br/>[user_keys.py]"]
  node_db[("Postgres data<br/>[session.py]")]
end

subgraph group_ops["Operations"]
  node_observability["Telemetry<br/>[observability.py]"]
end

node_user(("User"))
node_vllm["vLLM service"]
node_minio[("MinIO")]
node_telemetry_stack["OTel and metrics"]

node_user -->|"sends requests"| node_api
node_api -->|"registers routes"| node_authroutes
node_api -->|"registers routes"| node_chatroute
node_user -->|"logs in"| node_authroutes
node_chatroute -->|"resolves identity"| node_deps
node_deps -->|"decodes token"| node_security
node_authroutes -->|"uses token security"| node_security
node_chatroute -->|"routes work requests"| node_rm
node_rm -->|"classifies requests"| node_classifier
node_rm -->|"checks department"| node_dept
node_rm -->|"checks pending approvals"| node_approvals
node_rm -->|"runs graph"| node_execution
node_execution -->|"selects graph"| node_graphs
node_execution -->|"runs agents"| node_agents
node_agents -->|"uses tools"| node_tools
node_agents -->|"requests completions"| node_llm
node_llm -->|"calls inference"| node_vllm
node_tools -->|"checks access"| node_acl
node_tools -->|"uses object storage"| node_objects
node_objects -->|"enforces policy"| node_acl
node_objects -->|"reads and writes"| node_minio
node_acl -->|"reads policies"| node_db
node_vault -->|"stores encrypted secrets"| node_db
node_chatroute -->|"uses chat keys"| node_userkeys
node_userkeys -->|"wraps user keys"| node_db
node_llm -->|"records metrics"| node_observability
node_acl -->|"records decisions"| node_observability
node_observability -->|"exports telemetry"| node_telemetry_stack

click node_api "https://github.com/xtremislv/myai/blob/main/app/main.py"
click node_authroutes "https://github.com/xtremislv/myai/blob/main/app/api/routes_auth.py"
click node_chatroute "https://github.com/xtremislv/myai/blob/main/app/api/routes_chat.py"
click node_deps "https://github.com/xtremislv/myai/blob/main/app/api/deps.py"
click node_security "https://github.com/xtremislv/myai/blob/main/app/auth/security.py"
click node_rm "https://github.com/xtremislv/myai/blob/main/app/request_manager/router.py"
click node_classifier "https://github.com/xtremislv/myai/blob/main/app/request_manager/classifier.py"
click node_approvals "https://github.com/xtremislv/myai/blob/main/app/request_manager/approvals.py"
click node_dept "https://github.com/xtremislv/myai/blob/main/app/departments/packs.py"
click node_execution "https://github.com/xtremislv/myai/blob/main/app/orchestrator/execution.py"
click node_graphs "https://github.com/xtremislv/myai/blob/main/app/orchestrator/graph.py"
click node_agents "https://github.com/xtremislv/myai/blob/main/app/orchestrator/agents.py"
click node_tools "https://github.com/xtremislv/myai/blob/main/app/orchestrator/tools.py"
click node_llm "https://github.com/xtremislv/myai/blob/main/app/llm/client.py"
click node_acl "https://github.com/xtremislv/myai/blob/main/app/acl/engine.py"
click node_objects "https://github.com/xtremislv/myai/blob/main/app/storage/objects.py"
click node_vault "https://github.com/xtremislv/myai/blob/main/app/vault/aesgcm_vault.py"
click node_userkeys "https://github.com/xtremislv/myai/blob/main/app/vault/user_keys.py"
click node_db "https://github.com/xtremislv/myai/blob/main/app/db/session.py"
click node_observability "https://github.com/xtremislv/myai/blob/main/app/observability.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_api,node_authroutes,node_chatroute,node_deps,node_security,node_user toneBlue
class node_rm,node_classifier,node_approvals,node_dept,node_minio toneAmber
class node_execution,node_graphs,node_agents,node_tools,node_llm toneMint
class node_acl,node_objects,node_vault,node_userkeys,node_db toneRose
class node_observability,node_vllm,node_telemetry_stack toneIndigo
```

## Components

### API and identity

- [FastAPI app](https://github.com/xtremislv/myai/blob/main/app/main.py): `app/main.py`
- [Auth routes](https://github.com/xtremislv/myai/blob/main/app/api/routes_auth.py): `app/api/routes_auth.py`
- [Chat route](https://github.com/xtremislv/myai/blob/main/app/api/routes_chat.py): `app/api/routes_chat.py`
- [Auth dependencies](https://github.com/xtremislv/myai/blob/main/app/api/deps.py): `app/api/deps.py`
- [JWT security](https://github.com/xtremislv/myai/blob/main/app/auth/security.py): `app/auth/security.py`

### Request governance

- [Request Manager](https://github.com/xtremislv/myai/blob/main/app/request_manager/router.py): `app/request_manager/router.py`
- [Department classifier](https://github.com/xtremislv/myai/blob/main/app/request_manager/classifier.py): `app/request_manager/classifier.py`
- [Approval store](https://github.com/xtremislv/myai/blob/main/app/request_manager/approvals.py): `app/request_manager/approvals.py`
- [Department packs](https://github.com/xtremislv/myai/blob/main/app/departments/packs.py): `app/departments/packs.py`

### Agent execution

- [Graph execution](https://github.com/xtremislv/myai/blob/main/app/orchestrator/execution.py): `app/orchestrator/execution.py`
- [Agent graphs](https://github.com/xtremislv/myai/blob/main/app/orchestrator/graph.py): `app/orchestrator/graph.py`
- [Agent nodes](https://github.com/xtremislv/myai/blob/main/app/orchestrator/agents.py): `app/orchestrator/agents.py`
- [Agent tools](https://github.com/xtremislv/myai/blob/main/app/orchestrator/tools.py): `app/orchestrator/tools.py`
- [LLM client](https://github.com/xtremislv/myai/blob/main/app/llm/client.py): `app/llm/client.py`

### Data protection

- [ACL engine](https://github.com/xtremislv/myai/blob/main/app/acl/engine.py): `app/acl/engine.py`
- [Object storage](https://github.com/xtremislv/myai/blob/main/app/storage/objects.py): `app/storage/objects.py`
- [Encrypted vault](https://github.com/xtremislv/myai/blob/main/app/vault/aesgcm_vault.py): `app/vault/aesgcm_vault.py`
- [User chat keys](https://github.com/xtremislv/myai/blob/main/app/vault/user_keys.py): `app/vault/user_keys.py`
- [Postgres data](https://github.com/xtremislv/myai/blob/main/app/db/session.py): `app/db/session.py`

### Operations

- [Telemetry](https://github.com/xtremislv/myai/blob/main/app/observability.py): `app/observability.py`

### Other components

- **User**
- **vLLM service**
- **MinIO**
- **OTel and metrics**

## Connections

- User → FastAPI app: sends requests (evidence: `README.md`)
- FastAPI app → Auth routes: registers routes (evidence: `app/main.py`)
- FastAPI app → Chat route: registers routes (evidence: `app/main.py`)
- User → Auth routes: logs in (evidence: `README.md`)
- Chat route → Auth dependencies: resolves identity (evidence: `app/api/routes_chat.py`)
- Auth dependencies → JWT security: decodes token (evidence: `app/api/deps.py`)
- Auth routes → JWT security: uses token security (evidence: `app/api/routes_auth.py`)
- Chat route → Request Manager: routes work requests (evidence: `app/api/routes_chat.py`)
- Request Manager → Department classifier: classifies requests (evidence: `app/request_manager/router.py`)
- Request Manager → Department packs: checks department (evidence: `app/request_manager/router.py`)
- Request Manager → Approval store: checks pending approvals (evidence: `app/request_manager/router.py`)
- Request Manager → Graph execution: runs graph (evidence: `app/request_manager/router.py`)
- Graph execution → Agent graphs: selects graph (evidence: `app/orchestrator/execution.py`)
- Graph execution → Agent nodes: runs agents (evidence: `app/orchestrator/execution.py`)
- Agent nodes → Agent tools: uses tools (evidence: `app/orchestrator/agents.py`)
- Agent nodes → LLM client: requests completions (evidence: `app/orchestrator/agents.py`)
- LLM client → vLLM service: calls inference (evidence: `README.md`)
- Agent tools → ACL engine: checks access (evidence: `app/orchestrator/tools.py`)
- Agent tools → Object storage: uses object storage (evidence: `app/orchestrator/tools.py`)
- Object storage → ACL engine: enforces policy (evidence: `app/storage/objects.py`)
- Object storage → MinIO: reads and writes (evidence: `app/storage/objects.py`)
- ACL engine → Postgres data: reads policies (evidence: `app/acl/engine.py`)
- Encrypted vault → Postgres data: stores encrypted secrets (evidence: `app/vault/aesgcm_vault.py`)
- Chat route → User chat keys: uses chat keys (evidence: `app/api/routes_chat.py`)
- User chat keys → Postgres data: wraps user keys (evidence: `app/vault/user_keys.py`)
- LLM client → Telemetry: records metrics (evidence: `app/llm/client.py`)
- ACL engine → Telemetry: records decisions (evidence: `app/acl/engine.py`)
- Telemetry → OTel and metrics: exports telemetry (evidence: `app/observability.py`)
