KDCube Documentation
Understand the product, run it, learn the runtime boundary, then build only the app surfaces you need.
KDCube is an open-source AI application framework with an integrated self-hosted runtime. Keep an existing agent or start with the ready ReAct harness; add chat, streaming, files, integrations, isolated execution, services, UI, and economics incrementally.
These website pages are concise guides. The linked repository docs are the source of truth for exact contracts, recipes, and implementation details.
Recommended path
1. What KDCube Is
Framework, runtime, platform, one tenant/project deployment, apps, and provider/consumer surfaces.
2. Run It
Start the ready workspace, bring an existing agent, or create a focused app.
3. Understand the Runtime
Admission, concurrent workers, conversation lanes, buses, storage, identity, and execution boundaries.
4. Build an App
Canonical package contract, conditional surfaces, configuration, interfaces, storage, tests, and deployment.
Architecture Explorer
Interactive map of the whole platform — drill from experiences to infrastructure, with docs, how-tos, and recipes for every component.
Object Ecosystem
Named services, external events, scene surfaces, canvas, context pins, event/data bus, and provider policies.
Communication System
Conversation Event Bus, app Data Bus, outbound communicator, SSE, Socket.IO, REST, and semantic channels.
Client Integration
Browser transport contract, SSE events, Socket.IO, authentication, and reconnect behavior.
Connections & Integrations
OAuth/OIDC connected accounts, Gmail, Slack, provider-neutral mail, Telegram identity linking, delegated operators, consent, and hosted files.
Configuration
Descriptor-backed app configuration, secret lifecycles, provider/consumer surfaces, agents, MCP, sites, and runtime overrides.
Deployment & Monitoring
Docker Compose, ECS Fargate, Kubernetes, and observability setup.
Platform Economics
Spending events, per-user/app/conversation/turn attribution, budgets, helper rollups, and cold-cache accounting.
Security & Governance
Carried identity, surface authorization, delegated grants, sparse workspaces, trusted tools, and networkless generated-code execution.
ReAct Agentic Harness
Model-independent semantic channels, live event timeline, ANNOUNCE, logical refs, tools, skills, user choices, subagents, and isolated execution.
Claude Code Agent Support
App-native Claude Code runtime with per-turn accounting, workspace management, git-backed sessions, safety model, and integration patterns.
Glossary
Canonical definitions of KDCube platform terms: app, ReAct loop, timeline, source pool, tenant boundary, supervisor, executor, and more.