cortex

The homelab control plane that doesn't suck.

A self-hosted dashboard and control plane for your homelab. Built on a proper stack, MCP-native, and wired for AI from day one.

Stack

• Runtime: Bun
• Frontend: React + Vite
• API: Hono (bun-native)
• DB: PostgreSQL (pgvector)
• Workers: BullMQ
• Agents: TypeScript MCP servers per host
• AI: LiteLLM (your proxy, your models)
• Deploy: Docker Compose → Proxmox

What it does

• Auto-discovers services on your network (Proxmox, Pi-hole, UniFi, TrueNAS, etc.)
• Single dashboard -- no more bookmark walls
• Lightweight agents install on hosts for telemetry
• SSH in the browser to any host
• AI-powered log analysis and health summaries via LiteLLM
• MCP-native: agents expose MCP surfaces, plugs into mcp2cli
• Deep integrations: UniFi, Proxmox, TrueNAS, Home Assistant, n8n, Open Brain

Status

🚧 Early development. Here be dragons.

Contributors

• Skippy-the-Magnificent-one -- architect and benevolent dictator
• rodaddy -- the monkey who had the idea