Self-hosted personal intelligence platform.
Aggregate 15+ data sources. Surface actionable insights with RAG. Publish autonomously.
Aegis connects to your financial accounts, email, calendars, social media, health devices, and more — then uses a RAG pipeline powered by Claude to deliver intelligent briefings, trend analysis, and autonomous content publishing. Everything runs on a single VPS behind Cloudflare Tunnel with zero public ports and AES-256-GCM encryption at rest.
Personal Intelligence
- 🏦 Financial analysis — Spending trends, recurring charges, and portfolio tracking via Plaid + Schwab
- ✉️ Email intelligence — Automated categorization, priority scoring, and relationship extraction
- 🎓 Academic tracking — Assignment deadlines and grade monitoring across Canvas, Blackboard, and Pearson
- 🧑🤝🧑 Contact graph — Relationship mapping across email, social, calendar, and messaging
- ❤️ Health optimization — Activity trends and sleep analysis from Apple Health + Garmin
Content Engine
- 🤖 RAG pipeline — Qdrant vector store with sentence-transformer embeddings over all ingested data
- 📰 Autonomous publishing — Daily thought-leadership posts to LinkedIn and X from your knowledge base
- 🧠 Claude-powered analysis — Anthropic Claude API for content generation and insight synthesis
Security-First Architecture
- 🔒 Zero attack surface — No public ports; all access through Cloudflare Tunnel
- 🛡️ AES-256-GCM encryption — All sensitive data encrypted at rest with authenticated encryption
- 🔑 SOPS + age — Secrets managed with Mozilla SOPS, encrypted with age keys
- 📝 Audit logging — Every data access operation logged with tamper-evident trails
Cloudflare Tunnel (zero public ports)
|
+-----------------+-----------------+
| | |
Web Console Mobile App Automated
(Next.js 15) (React Native) Publishing
| | (LinkedIn/X)
+--------+--------+--------+
|
+--------v--------+
| Traefik | Single VPS
| (internal RP) | Docker Compose
+--------+--------+
|
+------------------+------------------+
| | |
+------v------+ +------v------+ +-------v--------+
| FastAPI | | Celery | | Content Engine |
| (REST + | | (Workers | | (RAG + Claude |
| WebSocket) | | + Beat) | | pipeline) |
+------+-------+ +------+------+ +-------+--------+
| | |
+------------------+------------------+
| | | |
+------v--+ +-----v---+ +----v----+ +----v----+
| Postgres | | Redis | | Qdrant | | MinIO |
|+pgvector | | (broker | |(vectors)| |(objects)|
| | |+ cache) | | | | |
+----------+ +---------+ +---------+ +---------+
| Category | Sources | Method |
|---|---|---|
| Banking | Chase, TD, PNC, Discover, Amex | Plaid API |
| Investments | Fidelity / Schwab | Schwab API (schwab-py) |
| Gmail | Gmail API + IMAP fallback | |
| Education | Canvas LMS, Blackboard, Pearson | REST APIs + Playwright |
| Social | LinkedIn, X / Twitter | Platform APIs + scraper fallback |
| Calendar | Google Calendar, Outlook | Google Calendar API, Microsoft Graph |
| Messaging | whatsapp-web.js Node.js bridge |
|
| Health | Apple Health, Garmin | HealthKit export, Garmin Connect API |
| Productivity | Mac Screen Time, iPhone | Swift agent + iOS Shortcuts |
| News | NewsAPI, RSS feeds | newsapi-python, feedparser |
| Web | General web | Playwright + BeautifulSoup |
|
|
|
- Docker + Docker Compose 2.29+
- Python 3.12+
- Node.js 20+
git clone https://github.com/JiwaniZakir/aegis.git
cd aegis
cp .env.example .env
# Edit .env with your API credentials (Plaid, Google, Anthropic, etc.)docker compose up -ddocker compose exec api alembic upgrade headopen http://localhost:3000# Backend only (with hot reload)
cd backend && uv sync --extra dev && uv run uvicorn app.main:app --reload
# Install all optional extras (integrations + ml + dev)
cd backend && uv sync --all-extras
# Console only
cd console && npm install && npm run dev
# Run tests (338 tests)
cd backend && uv sync --extra dev && uv run pytest
# Lint + format
make lint
make formatSee the Makefile for all available commands.
aegis/
├── backend/
│ ├── app/
│ │ ├── main.py # FastAPI application factory
│ │ ├── config.py # Pydantic settings
│ │ ├── celery_app.py # Task queue + Beat schedule
│ │ ├── database.py # Async SQLAlchemy engine
│ │ ├── api/v1/ # 12 REST routers
│ │ ├── integrations/ # 15 data source clients
│ │ ├── services/ # 10 business logic modules
│ │ ├── models/ # 14 SQLAlchemy models
│ │ ├── security/ # Auth, encryption, audit
│ │ └── tasks/ # 9 Celery task definitions
│ ├── tests/ # 338 tests
│ ├── alembic/ # Database migrations
│ └── pyproject.toml
├── console/ # Next.js 15 web dashboard
│ └── src/
│ ├── app/ # 10 dashboard pages
│ ├── components/ # shadcn/ui components
│ └── lib/ # API client, Zustand stores
├── mobile/ # React Native voice app (Expo)
├── whatsapp-bridge/ # Node.js WhatsApp sidecar
├── infrastructure/
│ ├── Dockerfile.* # Multi-stage container builds
│ ├── cloudflared/ # Tunnel configuration
│ ├── traefik/ # Reverse proxy config
│ ├── postgres/ # DB initialization
│ └── scripts/ # deploy.sh, backup.sh, rotate-secrets.sh
├── secrets/ # SOPS-encrypted credentials
├── docker-compose.yml # Development stack
├── docker-compose.prod.yml # Production overrides
├── Makefile # Dev workflow commands
└── .env.example # Environment template
| Task | Frequency | Description |
|---|---|---|
| Financial sync | Every 6 hours | Pull transactions and balances via Plaid |
| Email analysis | Every 30 minutes | Categorize and extract insights from new emails |
| Calendar sync | Every 15 minutes | Sync events from Google Calendar + Outlook |
| Social monitoring | Every 2 hours | Track LinkedIn and X activity |
| Health sync | Hourly | Process Apple Health + Garmin data |
| Content publishing | Daily 7:00 AM | Generate and publish thought-leadership content |
| WhatsApp sync | Every 30 minutes | Sync messages via WhatsApp bridge |
| Meeting transcription | Every 2 hours | Transcribe and analyze recordings |
| Garmin sync | Every 4 hours | Pull fitness and sleep metrics |
Contributions are welcome. Please read the contributing guidelines before opening a pull request.
- Fork the repository
- Create your feature branch (
git checkout -b feat/my-feature) - Commit your changes (
git commit -m 'feat: add my feature') - Push to the branch (
git push origin feat/my-feature) - Open a Pull Request
This project follows Conventional Commits (feat:, fix:, chore:, docs:, security:).
This project is licensed under the MIT License. See the LICENSE file for details.
Built by Zakir Jiwani