How ari-os/ari works
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: coordinator.ts Agent Coordinator · gateway.ts Gateway · memory-manager.ts Agent Memory · scheduler.ts Autonomous Scheduler
Components 23
User Interfaces
- CLI
src/cli - Dashboard
dashboard/src - REST API
src/api/routes.ts - Message Channels
src/channels
Kernel Security
- Gateway
src/kernel/gateway.ts - Input Sanitizer
src/kernel/sanitizer.ts - Audit Chain
src/kernel/audit.ts - Event Bus
src/kernel/event-bus.ts
Agents & Reasoning
- Agent Coordinator
src/agents/coordinator.ts - Governance
src/governance/policy-engine.ts - Cognitive Framework
src/cognition - Model Routing
src/ai/cascade-router.ts - Tool Execution
src/execution/tool-executor.ts
Autonomous Workflows
- Autonomous Scheduler
src/autonomous/scheduler.ts - Content Pipeline
src/plugins/content-engine - Video Pipeline
src/plugins/video-pipeline/pipeline-orchestrator.ts - Lead Discovery
src/integrations/crm
State & Operations
- Agent Memory
src/agents/memory-manager.ts - Document Ingestion
src/autonomous/ingestion-pipeline.ts - Local Storage
src/system/storage.ts - Observability
src/observability
Other components
- Operator
- External Providers
Connections 25
- 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
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
src/autonomous/ingestion-pipeline.ts - Document Ingestion → External Providers: creates embeddings
src/autonomous/ingestion-pipeline.ts - Agent Memory → Audit Chain: audits memory activity
src/agents/memory-manager.ts - Event Bus → Observability: feeds monitoring
src/observability/alert-manager.ts - Local Storage → Agent Memory: persists system state
- Tool Execution → External Providers: calls model and tool providers