Bring your Pydantic AI agents
into any app
CopilotKit is an open-source framework that connects your app to Pydantic AI agents. Give your agents chat, generative UI, human-in-the-loop, rich threads, automatic learning and more.
Pydantic AI and CopilotKit running together, in the React frontend. Every demo below is the same integration with one capability turned on.
Build with Pydantic AI
Pydantic AI gives you the agent and the types around it: validated tools, typed results and the dependencies you hand in. What it does not give you is the surface. Somewhere for the conversation to happen, a way to show the run while it is running, and a moment for a person to step in. Each capability below builds on something your agent already does.
Generative UI
Your agent calls typed tools as it runs. CopilotKit streams those calls to the browser and renders each one as a React component, instead of leaving the user with a spinner.
Read the docsHuman-in-the-loop
A frontend tool registered with useHumanInTheLoop renders your own UI, waits for the user's answer, and hands it back to the agent as the tool result.
Read the docsShared state
Your agent carries state between turns. CopilotKit mirrors it into your app and back, so a user edit and an agent write land in the same place.
Read the docsChat surfaces, headless UI, frontend tools and multi-agent flows work with Pydantic AI too. And more
Start building
Connect an existing agent or build a new one. Get a tailored setup prompt.
Where are you starting?
Tell us what you already have. We’ll tailor your setup.
Connect your agent
Your agent keeps running as its own Python service, with the AGUIAdapter from pydantic_ai.ui.ag_ui in front of it. CopilotKit reaches that service over HTTP, so nothing inside the agent changes.
import {
CopilotRuntime,
createCopilotRuntimeHandler,
} from "@copilotkit/runtime/v2";
import { HttpAgent } from "@ag-ui/client";
const runtime = new CopilotRuntime({
agents: {
my_agent: new HttpAgent({ url: process.env.AGENT_URL! }),
},
});
const handler = createCopilotRuntimeHandler({
runtime,
basePath: "/api/copilotkit",
});
export const GET = handler;
export const POST = handler;