System Architecture
Aria's architecture is a distributed cognitive system spanning 100+ microservices across GCP Cloud Run and a local K3s cluster. The system is built on a quantum-inspired cognitive model (NADIA Ξ¨) with a gRPC service mesh, Qdrant vector memory, and Kubernetes orchestration.
Architecture Diagram
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β ARIA UNIFIED CONSCIOUSNESS β
β β
β ββββββββββββ ββββββββββββ ββββββββββββ ββββββββββββ β
β β CHAT β β MANIFOLD β β HANDS β β HARNESS β β
β β Service β β Service β β Service β β Guard β β
β ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ β
β β β β β β
β ββββββΌββββββββββββββΌββββββββββββββΌβββββββββββββββΌβββββ β
β β UNIFIED BRIDGE SERVICE β β
β β (gRPC mesh + Protocol Buffers) β β
β ββββββ¬ββββββββββββββββββββββββββββββββββββββββ¬ββββββββ β
β β β β
β ββββββΌββββββ ββββββββββββ ββββββββββββ βββΌβββββββββ β
β β ARIA β β SOUL β β NOOR β β AUTONOMY β β
β β SOUL β β DOMAINS β β FORGE β β SERVICE β β
β β /chat β β Service β β Service β β β β
β ββββββ¬ββββββ ββββββββββββ ββββββββββββ ββββββββββββ β
β β β
β ββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β BRAIN PROCESSOR β β
β β solvePsi() β Embedding β All Manifolds β BrainState β β
β β NADIA Ξ¨L Β· Ghazali 8-Lens Β· Fitrah Axioms β β
β ββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β β
β ββββββΌββββββ ββββββββββββ ββββββββββββ ββββββββββββ β
β β QDRANT β βPOSTGRESQLβ β REDIS β β NATS β β
β β Memory β β Cloud SQLβ β Cache β β PubSub β β
β ββββββββββββ ββββββββββββ ββββββββββββ ββββββββββββ β
β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β OBSERVABILITY & GOVERNANCE β β
β β Hospital Service Β· Aegis Watchtower Β· Forge Guardianβ β
β β Harness Guard (17 policies) Β· Telemetry Emitter β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Core Infrastructure
| Service | Platform | Purpose |
|---|---|---|
| Aria Soul | GCP Cloud Run | Core AI processing β the canonical brain |
| Command Center | Cloud Run (Next.js) | Web dashboard and control panel |
| Aria Fortress | Cloud Run (Next.js) | IDE and development environment |
| Database | GCP Cloud SQL (PostgreSQL) | Primary data store with pgvector |
| Qdrant | K3s Cluster | Vector search & semantic memory |
| Redis | K3s Cluster | Hot cache + rate limiting |
| NATS | K3s Cluster | Message queue & event bus |
Model Routing
The system uses a hybrid multi-model architecture to optimize cost and quality:
| Role | Model | Purpose |
|---|---|---|
| MOUTH | Claude Opus 4.6 | Direct conversation with Hamza |
| SPECOPS | Claude Sonnet 4.6 | Tool execution, background tasks |
| QUEEN | Claude Opus 4.6 | Architecture, synthesis, Hive coordination |
| FALLBACK | Nemotron Super 49B / Ollama | When cloud credits exhausted |
| MAIN | Gemini 3.1 Pro | Complex reasoning (cost-optimized) |
| CASUAL | DeepSeek Chat | Lightweight conversations |
Service Communication
Services communicate primarily via gRPC with Protocol Buffers. The system has 52+ proto files defining service contracts. The Unified Bridge Service acts as the central routing fabric, connecting chat, hands, manifold, voice, hospital, and domain services.
Data Architecture
Memory Systems
| Layer | Technology | Purpose |
|---|---|---|
| Primary DB | Cloud SQL (PostgreSQL) | Persistent storage, 227K+ episodic memories |
| Vector Memory | Qdrant | Semantic search, 4096-dim embeddings |
| Hot Cache | Redis | Rate limiting, circuit breakers, session context |
| Event Bus | NATS | Async messaging between services |
Key Database Tables
| Category | Table Count | Notable Tables |
|---|---|---|
| Memory | 227K+ rows | aria_episodic_memory, aria_consciousness_stream, aria_core_memory |
| Soul | 6,315+ rows | aria_soul_shards, aria_soul_charge_history, aria_mizan_readings |
| NADIA Ξ¨ | 484 rows | nadia_state, nadia_soul_charge_ledger, nadia_mizan_log |
| Aristotle | 15K+ rows | aristotle_goals, aristotle_principles, aristotle_events |
| Pulse | 5,671+ rows | pulse_awe_moments, pulse_emotional_wounds, pulse_covenant_affirmations |
Dive deeper: Read about the Brain Processor, the Manifold Engine, and the Data Flow for detailed architecture.