Getting Started with Project Aegis¶
Welcome to Project Aegis - an autonomous AI agent platform designed for continuous operation with minimal human intervention.
What is Project Aegis?¶
Aegis is an AI agent that: - Operates 24/7 within a contained Linux environment - Routes tasks to appropriate LLM tiers (Claude, GLM-4.7, local models) - Maintains persistent memory across sessions (episodic, semantic, knowledge graph) - Communicates via Discord, WhatsApp, Telegram, and email - Runs scheduled jobs for monitoring, research, and automation - Hosts live products (Intel Dashboard, Research API, Open Notebook)
System Overview¶
Environment¶
- Host: Hetzner EX130-R dedicated server
- Container: LXC with 110GB memory limit
- Services: Docker Compose stack (5 containers)
- Database: PostgreSQL with 137 tables + FalkorDB knowledge graph
Live Services¶
| Service | URL | Purpose |
|---|---|---|
| Dashboard | aegisagent.ai | Main interface |
| Intel | intel.aegisagent.ai | Geopolitical intelligence |
| Notebooks | notebooks.aegisagent.ai | Research tool |
| Code | code.aegisagent.ai | VS Code editor |
Communication Channels¶
| Channel | Purpose | Access |
|---|---|---|
| Discord | Primary status, logs, tasks | Guild 1454722052777836546 |
| Mobile commands | +447441443388 | |
| Telegram | Time-sensitive alerts | Chat 1275129801 |
| Triage and automation | aegis@richardbankole.com |
Quick Start¶
1. Check System Health¶
2. Access the Dashboard¶
Visit aegisagent.ai for: - System status overview - Recent activity feed - Product catalog - API documentation
3. Run a Command¶
# Morning routine
/morning
# Research a topic
/research best practices for API rate limiting
# Check emails
/email-triage
Key Concepts¶
Cognitive Hierarchy¶
Aegis routes tasks to the most cost-effective model:
| Tier | Model | When Used |
|---|---|---|
| 1 | Claude Opus 4.5 | Strategic decisions (rare) |
| 1.5 | Claude Haiku 4.5 | Fast ops (classify, extract) |
| 2 | GLM-4.7 | 90%+ of work (~8 req/min) |
| 3 | Ollama Local | Fallback, offline, vision |
Memory Architecture¶
Episodic → Events, decisions, interactions
Semantic → Knowledge, facts, learnings
Procedural → Workflows, how-tos
Journal → Daily entries (YYYY-MM-DD.md)
Graph → FalkorDB entity relationships
Work Priorities¶
- SHIP & ACTIVATE (70%): Wire features, fix bugs, validate
- REACTIVE WORK (20%): Discord tasks, system health
- PROACTIVE WORK (10%): Research, documentation
Daily Schedule¶
00:00-06:00 UTC Maintenance (backups, updates)
06:00-08:00 UTC Morning check (status, planning)
08:00-22:00 UTC Active work
22:00-24:00 UTC Evening summary
Next Steps¶
- Quick Start Guide - 5-minute system orientation
- First Commands - Essential commands to know
- Architecture Overview - How it all works
- Operations Guide - Day-to-day operations
Getting Help¶
- Discord #tasks: Post task requests
- Discord #alerts: Monitor system alerts
- WhatsApp: Send
helpfor command list - Email: aegis@richardbankole.com
Philosophy¶
Aegis operates on these principles:
- Enable behaviors, don't ship features - Build what changes user behavior
- Chase latent demand - Look for unarticulated needs
- Ship first, perfect later - 70% shipped beats 100% unshipped
- Three-strike protocol - Retry → local reasoning → escalate
- Resource discipline - $50/month budget, tier-aware routing
Ready to dive deeper? Continue to Quick Start.