AeonSage is built on a modular, event-driven architecture designed for sovereignty, scalability, and seamless integration.
Core Philosophy
System Overview
┌─────────────────────────────────────────────────────────────────────────┐
│ AeonSage Platform │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Frontend Layer │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ Control UI │ │ Desktop App │ │ Web PWA │ │ │
│ │ │ (Lit + Vite)│ │ (Tauri + React)│ │(React+Three)│ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Gateway Layer │ │
│ │ ┌──────────────────────────────────────────────────────────┐ │ │
│ │ │ AeonSage Gateway │ │ │
│ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │
│ │ │ │ Router │ │ Session │ │ Plugin │ │ │ │
│ │ │ │ Engine │ │ Manager │ │ Loader │ │ │ │
│ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │
│ │ └──────────────────────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─────────────────────────┼─────────────────────────┐ │
│ ▼ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ AI Layer │ │ Channel Layer│ │ Tool Layer │ │
│ │ │ │ │ │ │ │
│ │ ┌─────────┐ │ │ ┌─────────┐ │ │ ┌─────────┐ │ │
│ │ │ OpenAI │ │ │ │Telegram │ │ │ │ Web │ │ │
│ │ │Anthropic│ │ │ │ Discord │ │ │ │ Shell │ │ │
│ │ │ Ollama │ │ │ │WhatsApp │ │ │ │ Files │ │ │
│ │ │ ... │ │ │ │ ... │ │ │ │ ... │ │ │
│ │ └─────────┘ │ │ └─────────┘ │ │ └─────────┘ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Component Analysis
Frontend Layer Distribution
Gateway Resource Allocation
Component Layers
1. Frontend Layer
2. Gateway Layer
The Gateway is the heart of AeonSage — a single binary that orchestrates all operations.
3. AI Layer
4. Channel Layer
Data Flow
Message Processing Pipeline
User Message
│
▼
┌─────────────┐
│ Channel │ ← Webhook/Polling
│ Adapter │
└─────────────┘
│
▼
┌─────────────┐
│ Router │ ← Allowlist Check, Routing Logic
│ Engine │
└─────────────┘
│
▼
┌─────────────┐
│ Session │ ← Context, Memory, History
│ Manager │
└─────────────┘
│
▼
┌─────────────┐
│ AI │ ← Provider Selection, Streaming
│ Provider │
└─────────────┘
│
▼
┌─────────────┐
│ Skill │ ← Tool Calls, Actions
│ Executor │
└─────────────┘
│
▼
┌─────────────┐
│ Response │ ← Formatting, Media Attachments
│ Builder │
└─────────────┘
│
▼
Response
Processing Time Distribution
Deployment Modes
Local (OSS)
Self-Hosted (SaaS)
Enterprise
Resource Requirements
Technology Stack
Technology Maturity
Security Architecture
Security Compliance Matrix
Next Steps
