# ari-os/ari architecture

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

- Interactive diagram: https://gitdiagram.com/ari-os/ari
- Repository: https://github.com/ari-os/ari

## Overview

ARI is a local-first, multi-agent AI operating system for business workflows, market monitoring, content creation, and intelligence briefings. Users initiate work through the CLI, dashboard, or messaging channels; the system routes requests through security and governance, coordinates agents and tools, then records activity and delivers results. Its documented capabilities also include autonomous scheduling, persistent memory, cognitive frameworks, content and lead pipelines, and operational monitoring. The README supports the layer relationships; source excerpts confirm selected implementations. Several subsystem links are documented rather than verified against unsampled code.

Main entry points: [`src/agents/coordinator.ts`](https://github.com/ari-os/ari/blob/main/src/agents/coordinator.ts) (Agent Coordinator), [`src/kernel/gateway.ts`](https://github.com/ari-os/ari/blob/main/src/kernel/gateway.ts) (Gateway), [`src/agents/memory-manager.ts`](https://github.com/ari-os/ari/blob/main/src/agents/memory-manager.ts) (Agent Memory), [`src/autonomous/scheduler.ts`](https://github.com/ari-os/ari/blob/main/src/autonomous/scheduler.ts) (Autonomous Scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["CLI"]
  node_dashboard["Dashboard"]
  node_api["REST API<br/>[routes.ts]"]
  node_channels["Message Channels"]
end

subgraph group_kernel["Kernel Security"]
  node_gateway["Gateway<br/>[gateway.ts]"]
  node_sanitizer["Input Sanitizer<br/>[sanitizer.ts]"]
  node_audit[("Audit Chain<br/>[audit.ts]")]
  node_eventbus["Event Bus<br/>[event-bus.ts]"]
end

subgraph group_reasoning["Agents &amp; Reasoning"]
  node_agents["Agent Coordinator<br/>[coordinator.ts]"]
  node_governance["Governance<br/>[policy-engine.ts]"]
  node_cognition["Cognitive Framework"]
  node_ai["Model Routing<br/>[cascade-router.ts]"]
  node_execution["Tool Execution<br/>[tool-executor.ts]"]
end

subgraph group_workflows["Autonomous Workflows"]
  node_autonomy["Autonomous Scheduler<br/>[scheduler.ts]"]
  node_content["Content Pipeline"]
  node_video["Video Pipeline"]
  node_leads["Lead Discovery"]
end

subgraph group_state["State &amp; Operations"]
  node_memory[("Agent Memory<br/>[memory-manager.ts]")]
  node_knowledge["Document Ingestion"]
  node_storage[("Local Storage<br/>[storage.ts]")]
  node_observability["Observability"]
end

node_operator(("Operator"))
node_external{{"External Providers"}}

node_operator -->|"issues commands"| node_cli
node_operator -->|"uses"| node_dashboard
node_operator -->|"sends messages"| node_channels
node_cli -.->|"requests services"| node_gateway
node_dashboard -.->|"requests data"| node_api
node_channels -.->|"routes messages"| node_gateway
node_api -.->|"exposes agent operations"| node_agents
node_gateway -->|"secures input"| node_sanitizer
node_gateway -->|"dispatches events"| node_eventbus
node_agents -->|"requests policy decisions"| node_governance
node_agents -->|"uses frameworks"| node_cognition
node_agents -.->|"routes model work"| node_ai
node_agents -->|"delegates tools"| node_execution
node_governance -->|"records decisions"| node_audit
node_agents -->|"stores and retrieves"| node_memory
node_autonomy -->|"schedules workflows"| node_content
node_autonomy -->|"schedules discovery"| node_leads
node_content -.->|"produces video assets"| node_video
node_video -->|"publishes to YouTube"| node_external
node_knowledge -->|"ingests source material"| node_external
node_knowledge -->|"creates embeddings"| node_external
node_memory -->|"audits memory activity"| node_audit
node_eventbus -.->|"feeds monitoring"| node_observability
node_storage -.->|"persists system state"| node_memory
node_execution -.->|"calls model and tool providers"| node_external

click node_cli "https://github.com/ari-os/ari/tree/main/src/cli"
click node_dashboard "https://github.com/ari-os/ari/tree/main/dashboard/src"
click node_api "https://github.com/ari-os/ari/blob/main/src/api/routes.ts"
click node_channels "https://github.com/ari-os/ari/tree/main/src/channels"
click node_gateway "https://github.com/ari-os/ari/blob/main/src/kernel/gateway.ts"
click node_sanitizer "https://github.com/ari-os/ari/blob/main/src/kernel/sanitizer.ts"
click node_audit "https://github.com/ari-os/ari/blob/main/src/kernel/audit.ts"
click node_eventbus "https://github.com/ari-os/ari/blob/main/src/kernel/event-bus.ts"
click node_agents "https://github.com/ari-os/ari/blob/main/src/agents/coordinator.ts"
click node_governance "https://github.com/ari-os/ari/blob/main/src/governance/policy-engine.ts"
click node_cognition "https://github.com/ari-os/ari/tree/main/src/cognition"
click node_ai "https://github.com/ari-os/ari/blob/main/src/ai/cascade-router.ts"
click node_execution "https://github.com/ari-os/ari/blob/main/src/execution/tool-executor.ts"
click node_autonomy "https://github.com/ari-os/ari/blob/main/src/autonomous/scheduler.ts"
click node_content "https://github.com/ari-os/ari/tree/main/src/plugins/content-engine"
click node_video "https://github.com/ari-os/ari/blob/main/src/plugins/video-pipeline/pipeline-orchestrator.ts"
click node_leads "https://github.com/ari-os/ari/tree/main/src/integrations/crm"
click node_memory "https://github.com/ari-os/ari/blob/main/src/agents/memory-manager.ts"
click node_knowledge "https://github.com/ari-os/ari/blob/main/src/autonomous/ingestion-pipeline.ts"
click node_storage "https://github.com/ari-os/ari/blob/main/src/system/storage.ts"
click node_observability "https://github.com/ari-os/ari/tree/main/src/observability"

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_cli,node_dashboard,node_api,node_channels toneBlue
class node_gateway,node_sanitizer,node_audit,node_eventbus toneAmber
class node_agents,node_governance,node_cognition,node_ai,node_execution toneMint
class node_autonomy,node_content,node_video,node_leads toneRose
class node_memory,node_knowledge,node_storage,node_observability,node_operator,node_external toneIndigo
```

## Components

### User Interfaces

- [CLI](https://github.com/ari-os/ari/tree/main/src/cli): `src/cli`
- [Dashboard](https://github.com/ari-os/ari/tree/main/dashboard/src): `dashboard/src`
- [REST API](https://github.com/ari-os/ari/blob/main/src/api/routes.ts): `src/api/routes.ts`
- [Message Channels](https://github.com/ari-os/ari/tree/main/src/channels): `src/channels`

### Kernel Security

- [Gateway](https://github.com/ari-os/ari/blob/main/src/kernel/gateway.ts): `src/kernel/gateway.ts`
- [Input Sanitizer](https://github.com/ari-os/ari/blob/main/src/kernel/sanitizer.ts): `src/kernel/sanitizer.ts`
- [Audit Chain](https://github.com/ari-os/ari/blob/main/src/kernel/audit.ts): `src/kernel/audit.ts`
- [Event Bus](https://github.com/ari-os/ari/blob/main/src/kernel/event-bus.ts): `src/kernel/event-bus.ts`

### Agents & Reasoning

- [Agent Coordinator](https://github.com/ari-os/ari/blob/main/src/agents/coordinator.ts): `src/agents/coordinator.ts`
- [Governance](https://github.com/ari-os/ari/blob/main/src/governance/policy-engine.ts): `src/governance/policy-engine.ts`
- [Cognitive Framework](https://github.com/ari-os/ari/tree/main/src/cognition): `src/cognition`
- [Model Routing](https://github.com/ari-os/ari/blob/main/src/ai/cascade-router.ts): `src/ai/cascade-router.ts`
- [Tool Execution](https://github.com/ari-os/ari/blob/main/src/execution/tool-executor.ts): `src/execution/tool-executor.ts`

### Autonomous Workflows

- [Autonomous Scheduler](https://github.com/ari-os/ari/blob/main/src/autonomous/scheduler.ts): `src/autonomous/scheduler.ts`
- [Content Pipeline](https://github.com/ari-os/ari/tree/main/src/plugins/content-engine): `src/plugins/content-engine`
- [Video Pipeline](https://github.com/ari-os/ari/blob/main/src/plugins/video-pipeline/pipeline-orchestrator.ts): `src/plugins/video-pipeline/pipeline-orchestrator.ts`
- [Lead Discovery](https://github.com/ari-os/ari/tree/main/src/integrations/crm): `src/integrations/crm`

### State & Operations

- [Agent Memory](https://github.com/ari-os/ari/blob/main/src/agents/memory-manager.ts): `src/agents/memory-manager.ts`
- [Document Ingestion](https://github.com/ari-os/ari/blob/main/src/autonomous/ingestion-pipeline.ts): `src/autonomous/ingestion-pipeline.ts`
- [Local Storage](https://github.com/ari-os/ari/blob/main/src/system/storage.ts): `src/system/storage.ts`
- [Observability](https://github.com/ari-os/ari/tree/main/src/observability): `src/observability`

### Other components

- **Operator**
- **External Providers**

## Connections

- Operator → CLI: issues commands
- Operator → Dashboard: uses
- Operator → Message Channels: sends messages
- CLI → Gateway: requests services
- Dashboard → REST API: requests data
- Message Channels → Gateway: routes messages
- REST API → Agent Coordinator: exposes agent operations
- Gateway → Input Sanitizer: secures input
- Gateway → Event Bus: dispatches events
- Agent Coordinator → Governance: requests policy decisions
- Agent Coordinator → Cognitive Framework: uses frameworks
- Agent Coordinator → Model Routing: routes model work
- Agent Coordinator → Tool Execution: delegates tools
- Governance → Audit Chain: records decisions (evidence: `src/governance/policy-engine.ts`)
- Agent Coordinator → Agent Memory: stores and retrieves
- Autonomous Scheduler → Content Pipeline: schedules workflows
- Autonomous Scheduler → Lead Discovery: schedules discovery
- Content Pipeline → Video Pipeline: produces video assets
- Video Pipeline → External Providers: publishes to YouTube
- Document Ingestion → External Providers: ingests source material (evidence: `src/autonomous/ingestion-pipeline.ts`)
- Document Ingestion → External Providers: creates embeddings (evidence: `src/autonomous/ingestion-pipeline.ts`)
- Agent Memory → Audit Chain: audits memory activity (evidence: `src/agents/memory-manager.ts`)
- Event Bus → Observability: feeds monitoring (evidence: `src/observability/alert-manager.ts`)
- Local Storage → Agent Memory: persists system state
- Tool Execution → External Providers: calls model and tool providers
