BrainHub — Einheitliches Web-Frontend + Netzlaufwerk + MCP-Gateway + Ops-Agent

Selbstgenutzter Haupteinstieg der Brain-Produktfamilie: Ein einzelner FastAPI-Prozess bündelt alle Panels (Wissensdatenbank / Suche / Netzlaufwerk / Kanban / Gedächtnis / Agent-Status / Betriebsprotokolle), stellt nach außen ein einziges MCP-Gateway bereit und enthält einen eingebauten Ops-Agent, der Wissensdatenbank und Gedächtnis automatisch pflegt.

Einführung

BrainHub ist der Nutzungseinstieg der Brain-Produktfamilie. Er bündelt alle Fähigkeiten der Produktfamilie in einer bedienbaren Oberfläche und einem Satz von APIs:

• Web-Panel: Jinja2 + HTMX ohne Frontend-Erstellung, Wissensdatenbank-Browsing / semantische Suche / Netzlaufwerk CRUD / Kanban-Aufgabenstatemachine / Team / Agent-Status / Ops-Protokolle

• JSON API v1: /api/v1/* für den React-Desktop-Client

• MCP-Gateway: Aggregiert 12 eigene BrainHub-Tools + BrainMem-Websitesuchwerkzeuge; jeder Agent verbindet nur diesen einen Einstieg

• Ops-Agent: Geplante Archivierung, Index-Neuaufbau, Gedächtnisextraktion, Health-Check

Im Selbstnutzungszeitraum startet ein brainhub start alle Hauptprozesse: importiert brainmem als Retrieval-Backend, startet den brain-bridge-Subprozess und wirkt nach außen wie eine Software.

Related MCP server: MCPHub

Eigenschaften

• 🖥️ Einheitliches Panel — 7 Seitentypen in einem Dienst zusammengefasst, HTMX-Partial-Refresh + Alpine, kein Frontend-Build-Chain

• 🔌 Einziger MCP-Einstieg — write_note / read_file / list_files / Projekt-Statemachine / health_check / send_matrix_msg + Weiterleitung der BrainMem-Suchwerkzeuge

• 🤖 Ops-Agent — APScheduler-basiert planbar: Archivierung / Index-Neuaufbau / Gedächtnisextraktion / Health Check, keine externe Orchestrierung

• 📁 Netzlaufwerk — BRAIN_ROOT-Dateibrowsing, Hochladen/Herunterladen, Thumbnail-Lazy-Generierung, Blockierung von Pfaden außerhalb des Bereichs und sensiblen Pfaden

• 📋 Kanban — Projekt-/Aufgabenstatemachine (todo → doing → blocked → done, strikte Übergänge)

• 🔗 Kollaborationsanbindung — leitet send_matrix_msg über Named Pipe an den BrainBridge-Daemon weiter, das Frontend empfängt Matrix-Nachrichten und Agent-Status in Echtzeit per WS

• 💻 Desktop-Same-Origin-Mounting — /app mountet die Build-Artefakte von brainhub-desktop, Same-Origin ohne CORS

Architektur

Schnellstart

# 安装（Python 3.10+，uv 管理；依赖 BrainMem editable 安装）
uv sync
uv pip install -e ../brainmem

# 启动（拉起 Web + MCP 网关 + brain-bridge 子进程）
uv run brainhub start

# 运维子命令
uv run brainhub ops archive
uv run brainhub ops reindex
uv run brainhub ops health

Dokumentationsindex

• PLAN.md — Implementierungsplan und aktueller Stand (Phase 1-3-Abnahme, Panels, Ops-Cron, MCP-Tool, Dependencies)

• docs/protocol-constitution.md — Protokoll-Verfassung: MCP-Toolsignatur / memory.db Schema / Matrix-Envelope

• ../brainmem/PRODUCT_FAMILY_PLAN.md – Produktfamilien-Globalplan (über Produktgrenzen hinaus, HX470-Migration, Risiko-Trade-offs)

Verwandte Projekte

Brain-Produktfamilie: BrainMem (Memory-Engine) · BrainHub (dieses Repository) · BrainBridge (Collaboration-Gateway)

相关项目

Brain-Produktfamilie: BrainMem（记忆引擎）· BrainHub（本仓库）· BrainBridge（协作网关）

test input