# bryanna-21/exile-ai architecture

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

- Interactive diagram: https://gitdiagram.com/bryanna-21/exile-ai
- Repository: https://github.com/bryanna-21/exile-ai

## Overview

EXILE is a desktop-capable AI assistant combining a React interface, an Electron shell, and a local API for chat, tasks, system control, and WhatsApp. The user-facing flow enters through the app and its feature screens; requests handled locally are routed by the API to domain services and return results to the interface. The tree also shows broad assistant capabilities such as voice, research, image tools, and device controls. The README is empty, so those unsampled feature relationships are not asserted; dashed links mark unverified integration.

Main entry points: [`EXILE-AI-main/local/server.mjs`](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/server.mjs) (Local API), [`EXILE-AI-main/src/App.tsx`](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/src/App.tsx) (App shell), [`EXILE-AI-main/local/task-api.mjs`](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/task-api.mjs) (Task API), [`EXILE-AI-main/electron/native-apps/index.cjs`](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/index.cjs) (Native app IPC)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Assistant interface"]
  node_app["App shell<br/>[App.tsx]"]
  node_assistant_features["Assistant features"]
  node_chat_ui["Chat interface<br/>[ChatSection.tsx]"]
  node_mission_ui["Mission control<br/>[MissionControl.tsx]"]
end

subgraph group_runtime["Desktop and API"]
  node_electron["Electron host<br/>[main.cjs]"]
  node_api_server["Local API<br/>[server.mjs]"]
  node_chat_stream["Provider chat<br/>[chat-stream.mjs]"]
end

subgraph group_tasks["Task execution"]
  node_task_api["Task API<br/>[task-api.mjs]"]
  node_task_orchestrator["Task orchestration"]
  node_task_store[("Task persistence<br/>[task-store.mjs]")]
  node_tool_registry["Task tools<br/>[tool-registry.mjs]"]
end

subgraph group_arc["System autonomy"]
  node_arc_autonomy["Autonomy engine"]
  node_arc_core["System core"]
  node_process_manager["Process manager"]
end

subgraph group_messaging["WhatsApp"]
  node_whatsapp["WhatsApp service<br/>[whatsapp.mjs]"]
  node_whatsapp_automation["WhatsApp automation"]
  node_whatsapp_files["File generation"]
end

subgraph group_native["Native apps"]
  node_native_index["Native app IPC<br/>[index.cjs]"]
  node_native_discovery["App discovery<br/>[discovery.cjs]"]
  node_native_service["App management<br/>[service.cjs]"]
  node_native_validation["App validation<br/>[validation.cjs]"]
end

node_user(("User"))

node_user -.->|"uses"| node_app
node_app -.->|"presents"| node_assistant_features
node_app -.->|"routes to"| node_chat_ui
node_app -.->|"routes to"| node_mission_ui
node_electron -->|"starts"| node_api_server
node_electron -->|"registers IPC"| node_native_index
node_api_server -->|"streams chat"| node_chat_stream
node_api_server -->|"routes tasks"| node_task_api
node_api_server -->|"lists and stops"| node_process_manager
node_api_server -->|"serves requests"| node_whatsapp
node_api_server -->|"reads config"| node_whatsapp_automation
node_api_server -->|"creates files"| node_whatsapp_files
node_task_api -->|"delegates to"| node_task_orchestrator
node_task_api -->|"reads and writes"| node_task_store
node_task_api -->|"uses tools"| node_tool_registry
node_arc_autonomy -->|"collects snapshots"| node_arc_core
node_native_index -->|"dispatches to"| node_native_service
node_native_index -->|"dispatches to"| node_native_discovery
node_native_index -->|"uses"| node_native_validation
node_native_service -->|"imports scan"| node_native_discovery
node_native_service -->|"validates entries"| node_native_validation

click node_app "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/src/App.tsx"
click node_assistant_features "https://github.com/bryanna-21/exile-ai/tree/main/EXILE-AI-main/src/components"
click node_chat_ui "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/src/components/ChatSection.tsx"
click node_mission_ui "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/src/components/MissionControl.tsx"
click node_electron "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/main.cjs"
click node_api_server "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/server.mjs"
click node_chat_stream "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/chat-stream.mjs"
click node_task_api "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/task-api.mjs"
click node_task_orchestrator "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/task-orchestrator.mjs"
click node_task_store "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/task-store.mjs"
click node_tool_registry "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/tool-registry.mjs"
click node_arc_autonomy "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/arc-autonomy-engine.mjs"
click node_arc_core "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/arc-system-core.mjs"
click node_process_manager "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/arc-process-manager.mjs"
click node_whatsapp "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/whatsapp.mjs"
click node_whatsapp_automation "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/whatsapp-automation.mjs"
click node_whatsapp_files "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/whatsapp-file-generation.mjs"
click node_native_index "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/index.cjs"
click node_native_discovery "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/discovery.cjs"
click node_native_service "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/service.cjs"
click node_native_validation "https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/validation.cjs"

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_app,node_assistant_features,node_chat_ui,node_mission_ui,node_user toneBlue
class node_electron,node_api_server,node_chat_stream toneAmber
class node_task_api,node_task_orchestrator,node_task_store,node_tool_registry toneMint
class node_arc_autonomy,node_arc_core,node_process_manager toneRose
class node_whatsapp,node_whatsapp_automation,node_whatsapp_files toneIndigo
class node_native_index,node_native_discovery,node_native_service,node_native_validation toneTeal
```

## Components

### Assistant interface

- [App shell](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/src/App.tsx): `EXILE-AI-main/src/App.tsx`
- [Assistant features](https://github.com/bryanna-21/exile-ai/tree/main/EXILE-AI-main/src/components): `EXILE-AI-main/src/components`
- [Chat interface](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/src/components/ChatSection.tsx): `EXILE-AI-main/src/components/ChatSection.tsx`
- [Mission control](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/src/components/MissionControl.tsx): `EXILE-AI-main/src/components/MissionControl.tsx`

### Desktop and API

- [Electron host](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/main.cjs): `EXILE-AI-main/electron/main.cjs`
- [Local API](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/server.mjs): `EXILE-AI-main/local/server.mjs`
- [Provider chat](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/chat-stream.mjs): `EXILE-AI-main/local/chat-stream.mjs`

### Task execution

- [Task API](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/task-api.mjs): `EXILE-AI-main/local/task-api.mjs`
- [Task orchestration](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/task-orchestrator.mjs): `EXILE-AI-main/local/task-orchestrator.mjs`
- [Task persistence](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/task-store.mjs): `EXILE-AI-main/local/task-store.mjs`
- [Task tools](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/tool-registry.mjs): `EXILE-AI-main/local/tool-registry.mjs`

### System autonomy

- [Autonomy engine](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/arc-autonomy-engine.mjs): `EXILE-AI-main/local/arc-autonomy-engine.mjs`
- [System core](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/arc-system-core.mjs): `EXILE-AI-main/local/arc-system-core.mjs`
- [Process manager](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/arc-process-manager.mjs): `EXILE-AI-main/local/arc-process-manager.mjs`

### WhatsApp

- [WhatsApp service](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/whatsapp.mjs): `EXILE-AI-main/local/whatsapp.mjs`
- [WhatsApp automation](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/whatsapp-automation.mjs): `EXILE-AI-main/local/whatsapp-automation.mjs`
- [File generation](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/local/whatsapp-file-generation.mjs): `EXILE-AI-main/local/whatsapp-file-generation.mjs`

### Native apps

- [Native app IPC](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/index.cjs): `EXILE-AI-main/electron/native-apps/index.cjs`
- [App discovery](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/discovery.cjs): `EXILE-AI-main/electron/native-apps/discovery.cjs`
- [App management](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/service.cjs): `EXILE-AI-main/electron/native-apps/service.cjs`
- [App validation](https://github.com/bryanna-21/exile-ai/blob/main/EXILE-AI-main/electron/native-apps/validation.cjs): `EXILE-AI-main/electron/native-apps/validation.cjs`

### Other components

- **User**

## Connections

- User → App shell: uses
- App shell → Assistant features: presents (evidence: `EXILE-AI-main/src/App.tsx`)
- App shell → Chat interface: routes to
- App shell → Mission control: routes to
- Electron host → Local API: starts (evidence: `EXILE-AI-main/electron/main.cjs`)
- Electron host → Native app IPC: registers IPC (evidence: `EXILE-AI-main/electron/main.cjs`)
- Local API → Provider chat: streams chat (evidence: `EXILE-AI-main/local/server.mjs`)
- Local API → Task API: routes tasks (evidence: `EXILE-AI-main/local/server.mjs`)
- Local API → Process manager: lists and stops (evidence: `EXILE-AI-main/local/server.mjs`)
- Local API → WhatsApp service: serves requests (evidence: `EXILE-AI-main/local/server.mjs`)
- Local API → WhatsApp automation: reads config (evidence: `EXILE-AI-main/local/server.mjs`)
- Local API → File generation: creates files (evidence: `EXILE-AI-main/local/server.mjs`)
- Task API → Task orchestration: delegates to (evidence: `EXILE-AI-main/local/task-api.mjs`)
- Task API → Task persistence: reads and writes (evidence: `EXILE-AI-main/local/task-api.mjs`)
- Task API → Task tools: uses tools (evidence: `EXILE-AI-main/local/task-api.mjs`)
- Autonomy engine → System core: collects snapshots (evidence: `EXILE-AI-main/local/arc-autonomy-engine.mjs`)
- Native app IPC → App management: dispatches to (evidence: `EXILE-AI-main/electron/native-apps/index.cjs`)
- Native app IPC → App discovery: dispatches to (evidence: `EXILE-AI-main/electron/native-apps/index.cjs`)
- Native app IPC → App validation: uses (evidence: `EXILE-AI-main/electron/native-apps/index.cjs`)
- App management → App discovery: imports scan (evidence: `EXILE-AI-main/electron/native-apps/service.cjs`)
- App management → App validation: validates entries (evidence: `EXILE-AI-main/electron/native-apps/service.cjs`)
