← Back to the Suite
Event Backbone

The brain
that connects.

QuantaHub is the central nervous system of the AgentQuanta suite. Real-time event streaming, encrypted terminal audit, and secure cross-app communication — running locally on cert-pinned WebSockets.

Get Started Free →
QuantaHub
local · encrypted
QuantaCanvas
Canvas events & sessions
:4001
AgentTUI
Terminal stdin/stdout audit
:4002
AgentWhisper
Dictation events
:4000
AgentEKG
Hook event stream
WSS :5173

Everything talks.
Nothing leaks.

QuantaHub is the event layer every other AgentQuanta tool relies on. It runs locally, starts automatically with QuantaCanvas, and requires zero configuration.

Real-Time Event Streaming

A WebSocket stream (wss://host/stream) broadcasts hook events to every connected card in real time — event, batch_update, and clear_all message types. AgentEKG cards receive live tool calls, errors, and agent decisions the moment they happen. No polling. No latency.

🔒
Certificate-Pinned Security

Every connection to QuantaHub uses TLS with certificate pinning — clients only trust the hub's own self-signed cert, ignoring system CAs entirely. Bearer token authentication on every API call. The token never reaches the JavaScript layer. An attacker with access to the frontend still can't talk to the hub.

🖥️
Terminal Audit Pipeline

All stdin and stdout from every AgentTUI pane flows to QuantaHub on port 4002 — ANSI-stripped, non-blocking, batched every 5 seconds or 8KB per pane. Sensitive keyword detection flags sudo prompts, tokens, passwords, and AWS credentials automatically. Full session observability with zero throughput impact.

🧠
Cross-App Event Bus

Every tool in the suite — QuantaCanvas, AgentWhisper, AgentTUI, AgentEKG — registers with QuantaHub on startup. Events from any app are immediately available to every other app. One hub, one event history, one source of truth across your entire agent workflow.

↩️
Human-in-the-Loop Support

QuantaHub supports bidirectional event responses — apps can post a response back to an event ID, enabling human approval flows. An agent pauses and waits. You respond via the hub. The agent continues. The entire interaction is logged and auditable.

🔄
Zero-Config Auto-Recovery

Client connections use exponential backoff reconnection — 2 seconds up to 60 seconds — with graceful degradation when the hub is unreachable. QuantaHub auto-generates its TLS config and bearer token on first run, stored at ~/Library/Application Support/quantahub/. Apps discover it automatically.

Local. Encrypted.
Always on.

QuantaHub starts with QuantaCanvas and runs entirely on your machine. No cloud account, no external service, no data leaving your environment.

Ports & Protocols
  • :4000 — Dictation endpoint (QuantaCanvas)
  • :4001 — Primary API + event management (HTTPS)
  • :4002 — Terminal audit logging (HTTPS)
  • :5173 — Real-time WebSocket event stream (WSS)
  • TLS on all channels, certificate pinning via rustls
  • Bearer token auth on every authenticated call
Audit Pipeline
  • ANSI-stripped terminal output per pane
  • Batched flush: 5s interval or 8KB per pane
  • Bounded channels (2048 items) — non-blocking by design
  • Sensitive pattern detection: tokens, passwords, SSH keys, AWS credentials
  • Distinguishes stdout, stdin, commands, sudo escalations
  • Per-pane session lifecycle (open/close) tracking
Event API
  • GET /events/recent — retrieve with limit + source filter
  • POST /events — post new event from any app
  • POST /events/{id}/respond — HITL response
  • DELETE /events — clear all events
  • POST /agents/register — app registration
  • GET /health — unauthenticated connectivity check
Auto-Configuration
  • Self-signed TLS cert generated on first run
  • Bearer token auto-generated and stored securely
  • Config written to ~/Library/Application Support/quantahub/
  • All suite apps discover config automatically
  • Exponential backoff reconnect: 2s → 60s
  • Graceful degradation when hub is unreachable

The backbone everything else runs on.

AgentEKG watches it. AgentTUI audits through it. AgentWhisper posts to it. QuantaCanvas orchestrates it. QuantaHub is what makes the suite a suite — not just a collection of tools.