The Brain
Local-first, event-driven core that every project plugs into.
AI Orchestrator
Turn raw events into intelligent actions. This is the one piece worth building custom — the glue that makes Centra more than the sum of its containers.
The always-on brain: local AI, a durable event bus, a self-describing device registry, and a power-cut-aware health monitor. It runs on the laptop (Intel i7 + RTX 4060) today and migrates to a dedicated NAS later — and because every service is containerized, that migration is a copy-paste rather than a rebuild. Centra is not a project you finish; it is the ground every other project stands on.
Architecture
A modular brain: a small always-on core set up once, plus projects that attach as manifest-declared modules you add as you go. The core owns the brain-level work — coordination, memory, reasoning, anticipation, scheduling, notification — and delegates specialized capture/actuation to modules. It does most brain things, not everything.
- A module registers via its manifest → capability registry, event subscriptions, and MCP tools are wired in; the core is unchanged.
- Devices and modules publish events (MQTT edge → gateway → NATS JetStream) — durable and replayable.
- The orchestrator reacts to events and, on a schedule, reasons over shared state (events, telemetry, memory) using module-provided MCP tools.
- The anticipation engine predicts likely needs and acts proactively — or asks — then notifies you.
- State is written back to the shared data plane so the next decision is better-informed.
What Centra does for you
Centra is a limited JARVIS/FRIDAY — a support system, not an autonomous do-everything agent. It owns the brain-level work (remembering, watching, reasoning, anticipating, reminding, coordinating) and keeps you in the loop for anything consequential. It assists; it does not autonomously build, spend, or send on your behalf.
- Persistent memory of your preferences, patterns, and decisions
- Scheduled reasoning that surfaces what needs you before you ask
- Reactive reasoning on events via the local LLM + module tools
- Morning / evening briefings from the live state
- Reminders & follow-through (the Blu module)
- Severity- and power-cut-aware notifications, one place
- Home & ambient awareness (Aura / Sentry)
- Personal knowledge RAG with citations (Atlas)
- Local voice — wake, ask, speak, fully offline
- Tracks the plan from the source of truth
- Preps checklists, scripts, and status — it does not autonomously write or ship code
- No irreversible or outward action without your confirmation
- No autonomous engineering — building stays with you
- Local-first; nothing leaves the house without consent
- A small, typed, fully-logged tool surface
Phase rail
Progress log
- 2026-08-18
Scaffolded the containerized brain (compose, gateway, edge agent, infra) and pushed to git. Added the power-cut-aware resilience architecture.
- 2026-08-18
Rebuilt the hub as a Next.js app (Vercel-ready, centra.krinc.in) with an animated project map, per-project overview pages, and engineered phase pages.
- 2026-08-18
Added CLAUDE.md operating manual + per-project folder convention so the AI works directly from this repo against the source of truth (web/content/centra.json).
- 2026-08-18
Redesigned the home as a revolving 3D atom (crisp, no hero text; hover pauses + zooms; orbs grow with progress) and added an animated atom logo. Documented Centra's feature set as a limited support assistant (docs/centra-features.md) and shipped a one-shot S1 local-AI bring-up script.
- 2026-08-18
S0 complete: Docker Desktop running and the RTX 4060 (driver 610.88, 8 GB) verified inside a container. Started S1 — bringing up the local AI stack (Ollama + Qwen + embeddings + Open WebUI) on the GPU. Home tuned to a clean 2D orbital rotation with 3D orbs; base page has no header/footer.
- 2026-08-19
S1 done: qwen3:8b answering offline at 100% GPU (~16 tok/s) + nomic-embed embeddings + Open WebUI. S2 data plane and S3 event backbone are up and healthy, and the event pipeline is proven end-to-end. Voice STT/TTS re-scoped to the Blu module. Next core phase: S4 (AI Orchestrator), on hold while Blu is the active project.
- 2026-08-19
Moved the whole stack to an uncommon host-port block (48600–48612) to avoid clashes; container-internal ports unchanged. Added one-click Windows launchers: centra-start / centra-stop / centra-status.