Back to Copilotkit

OSS vs Enterprise

showcase/shell-docs/src/content/docs/concepts/oss-vs-enterprise.mdx

1.57.25.4 KB
Original Source

CopilotKit ships in two layers: an open-source frontend stack (npm packages, no external service required) and an Enterprise Intelligence Platform that adds durable conversations, realtime sync, observability, and an admin console. Enterprise extends OSS — same SDK, same runtime — so the boundary is about which capabilities you unlock, not which code you write.

The 30-second version

  • OSS is enough for building a working agentic React app with hooks, prebuilt chat, frontend tools, gen-UI, and any AG-UI integration. Apache 2.0, runs anywhere.
  • Enterprise adds durable threads, persistence across reloads and devices, realtime WebSocket sync, observability connectors, and a hosted admin console.
  • Enterprise runs two ways — fully hosted as Copilot Cloud, or self-hosted via the copilot-intelligence Helm chart on your own Kubernetes.
  • Your app code doesn't change between OSS-only, Cloud, and Self-Hosted. The boundary is a runtime config switch.
OSS onlyNeeds Enterprise
Agent chat, frontend tools, agent state, gen-UIYes
Any AG-UI integration (LangGraph, Mastra, Built-in, custom)Yes
Conversation history that survives reloads / devicesYes
useThreads + realtime sync across tabs / devicesYes
Hosted inspector, admin console, multi-tenancyYes
Enterprise observability connectorsYes

What's in the open-source core

Everything you need to build a working agentic React app, with no external service from CopilotKit:

  • Frontend SDK@copilotkit/react-core, exporting both hooks (useAgent, useFrontendTool, useAgentContext, useThreads, etc.) and prebuilt components (CopilotChat, CopilotSidebar, CopilotPopup).
  • Runtime@copilotkit/runtime, the request handler that mounts in your application server. Framework-agnostic core plus thin adapters for Express, Hono, Bun, Deno, Cloudflare Workers.
  • AG-UI protocol — open standard for agent ↔ frontend communication. 16 standardized event types, transport-agnostic.
  • Built-in AgentBuiltInAgent runs an in-process agent loop (OpenAI / Anthropic / Google / any AI-SDK model) without requiring an external framework.
  • Integrations — first-party adapters for LangGraph (Python / TypeScript / FastAPI), Mastra, CrewAI, Pydantic AI, Microsoft Agent Framework, AWS Strands, Google ADK, and others.
  • Generative UI primitives — tool rendering, state rendering, headless hooks, Slots-based theming.

Apache 2.0 licensed. Run it on any host, in any cloud, with any LLM provider.

What's in Enterprise (Enterprise Intelligence Platform)

A separate backend service that sits beside your runtime and unlocks the capabilities that need durable, multi-tenant infrastructure to be honest about:

  • Threads & Persistence — durable, resumable conversations that survive page reloads, span devices, and sync in realtime via WebSocket. Backed by Postgres + Redis with single-writer locks on active runs.
  • Observability — structured logging, traces of every AG-UI event, agent run metrics, and connectors for Datadog / OpenTelemetry / your existing observability stack.
  • Inspector & Admin Console — a hosted web UI for browsing thread history, inspecting agent traces, rotating API keys, and managing projects and organizations.
  • Multi-tenancy — three-level isolation (organizations, projects, users) so a single deployment can host production and staging side by side without one reading the other's data.

Hosted vs Self-Hosted

Same Enterprise Intelligence Platform — you pick where it runs:

  • Copilot Cloud is the hosted service. Sign up, get an API key, point your runtime at it. Pick this when you want zero ops on the platform side.
  • Self-Hosted installs the copilot-intelligence Helm chart into your own Kubernetes cluster. Pick this for data residency, on-prem requirements, or compliance control. You operate the workload (Postgres, Redis, ingress, OIDC, secret rotation); the chart and the same Enterprise image power the install.

Application code doesn't change between Cloud and Self-Hosted — same SDK, same runtime, same hooks. Just a different INTELLIGENCE_URL environment variable.

Where the boundary lives

The OSS runtime knows how to talk to the Enterprise Intelligence Platform but doesn't require it.

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.

Where to go next

  • Open-source quickstartQuickstart gets a working agentic app running in ~10 minutes against the Built-in Agent. No platform credentials needed.
  • Enterprise overviewPremium Overview lists every Enterprise capability and the per-feature setup.
  • Hosted setupCopilot Cloud for the hosted Enterprise Intelligence Platform.
  • Self-hosted deploymentSelf-Hosting Intelligence for the Helm-chart install on your own Kubernetes cluster.
  • Architecture deep-diveEnterprise Intelligence Platform internals covers the control-plane / data-plane split, the three workloads, and the operational model.