CopilotKit / Intelligence Runtime GuideFive languages · One runner

Developer guide / packages

Packages and local setup

Choose the library for your server. Each package README provides installation steps and a working example.

Draft · The release review is in progress.

TypeScript

@copilotkit/runtime/v2 exports CopilotIntelligenceRuntime. The Node listener mounts its multi-route API.

CopilotKitIntelligence is the standalone SDK from @copilotkit/runtime/v2. It calls Intelligence without mounted Runtime routes.

The Runtime constructs IntelligenceAgentRunner and rejects a caller-supplied runner.

Read the TypeScript README

Python

packages/runtime-python contains the ASGI application. Public classes include IntelligenceRuntime, RuntimeConfig, User, and HttpAgent.

Import Intelligence from copilotkit_intelligence for standalone SDK calls. The separate copilotkit_runtime import supplies the ASGI Runtime.

The package requires Python 3.11 or later. The build produces a wheel and source distribution.

pip install ./packages/runtime-python
Read the Python README

Go

packages/runtime-go contains a net/http handler. The host supplies a user callback and agent map.

Import runtime-go/intelligence for standalone SDK calls. The runtime-go package supplies the HTTP Runtime.

The runtime owns its gateway and exporter lifecycle. The host closes the runtime during shutdown.

Read the Go README

Ruby and Rails

packages/runtime-ruby contains a Rack application that Rails can mount. Native agents yield AG-UI event hashes.

Load copilotkit/intelligence for standalone SDK calls. Load copilotkit/runtime when your application needs Rack or Rails routes.

A Rails driver runs the shared suite through an actual Rails application. The package build produces a gem.

Read the Ruby and Rails README

C#

packages/runtime-dotnet contains an ASP.NET Core library. IntelligenceRuntime.Map mounts the API.

CopilotKit.Intelligence is the standalone SDK package. CopilotKit.Intelligence.Runtime is the separate ASP.NET Core package.

The current target is .NET 9. The host supplies RuntimeOptions, IRuntimeAgent implementations, and trusted user resolution.

Package READMEs contain full setup examples. The test drivers are not production authentication examples.

Read the C# README
Read the source packages