copilotkit--copilotkit/skills/runtime/references/wiring-agno.md

Agno — wired via the generic HttpAgent from @ag-ui/client. Requires an /agui URL suffix.

Install

pnpm add @ag-ui/client

Minimal wire-up

import {
  CopilotRuntime,
  createCopilotRuntimeHandler,
} from "@copilotkit/runtime/v2";
import { HttpAgent } from "@ag-ui/client";

const runtime = new CopilotRuntime({
  agents: {
    default: new HttpAgent({
      url: process.env.AGNO_URL ?? "http://localhost:8000/agui",
    }),
  },
});

const handler = createCopilotRuntimeHandler({
  runtime,
  basePath: "/api/copilotkit",
});

export default { fetch: handler };

Gotcha — the /agui suffix is mandatory

Agno's AG-UI FastAPI app mounts at /agui. Pointing url at the server root (http://localhost:8000) returns 404. Always include /agui.

Source: docs/content/docs/integrations/agno/quickstart.mdx:215.