showcase/shell-docs/src/content/docs/concepts/oss-vs-enterprise.mdx
CopilotKit is two products in one repository: an open-source frontend stack that anyone can install from npm and run with no service dependencies, and an Enterprise Intelligence Platform that adds durable conversations, realtime sync, observability, and an admin console. The two are layered — Enterprise extends OSS — so picking the right scope means understanding what each one gives you and where the boundary lives.
The OSS layer is everything you need to build a working agentic React app. It runs without any external service from CopilotKit:
@copilotkit/react-core (hooks: useAgent, useFrontendTool, useAgentContext, useThreads, etc.) and @copilotkit/react-ui (prebuilt components: CopilotChat, CopilotSidebar, CopilotPopup).@copilotkit/runtime, the request handler that mounts in your application server. Framework-agnostic core plus thin adapters for Express, Hono, Bun, Deno, Cloudflare Workers.BuiltInAgent runs an in-process agent loop (OpenAI / Anthropic / Google / any AI-SDK model) without requiring an external framework.Apache 2.0 licensed. Run it on any host, in any cloud, with any LLM provider.
Enterprise is a separate backend service that sits beside your runtime and unlocks capabilities that need durable, multi-tenant infrastructure to be honest about:
Two deployment modes — same Intelligence Platform, you pick where it runs:
copilot-intelligence Helm chart into your own Kubernetes cluster. Right when you need data residency, on-prem requirements, or compliance control. You operate the workload (Postgres, Redis, ingress, OIDC, secret rotation) but the chart and the same Intelligence Platform image power the install.Application code does not change between Cloud and Self-Hosted. Same SDK, same runtime, same hooks — just a different INTELLIGENCE_URL environment variable.
The OSS runtime knows how to talk to the Intelligence Platform but doesn't require it. Concretely:
| Capability | OSS only | Needs Intelligence Platform |
|---|---|---|
| Agent chat with prebuilt components | ✅ | |
| Frontend tools, agent state, generative UI | ✅ | |
| Tool rendering, state rendering, A2UI, MCP apps | ✅ | |
| Headless hooks for fully custom UIs | ✅ | |
| Any AG-UI integration (LangGraph, Mastra, etc.) | ✅ | |
| Built-in Agent + custom AG-UI agents | ✅ | |
| Conversation history that persists across page reloads | ✅ | |
useThreads (list, create, rename, archive, sync) | ✅ | |
| Realtime sync of threads across tabs / devices | ✅ | |
| Hosted inspector and admin console | ✅ | |
| Enterprise observability connectors | ✅ | |
| Self-hosted multi-tenant deployment | ✅ |
If your app keeps state in your own backend (Postgres, your own auth) and you're fine reconstructing thread context from your own store, OSS may be enough. The moment you want CopilotKit to be the conversation persistence layer — across users, devices, and sessions — Enterprise is the right answer.