How to run copilot runtime in python instead of nodejs?

[aakashlf]

How to run copilot runtime in python instead of nodejs?
I only see nodejs based runtime server implementation, how run the copilot runtime in python based server?

[linear]

CPK-3934 How to run copilot runtime in python instead of nodejs?

[copilotkit-support-bot]

You can run the Copilot runtime in Python using the CopilotKit Python SDK, which provides a FastAPI-based server implementation as an alternative to the Node.js runtime.

Details

Python-Based CopilotKit Runtime

CopilotKit provides a comprehensive Python SDK that allows you to run copilot runtime servers using Python and FastAPI instead of Node.js.

Installation

• Install the CopilotKit Python SDK:

pip install copilotkit

• For CrewAI integration:

pip install "copilotkit[crewai]"

FastAPI Server Implementation

• Create a Python FastAPI server with CopilotKit:

from fastapi import FastAPI
from copilotkit.integrations.fastapi import add_fastapi_endpoint
from copilotkit import CopilotKitRemoteEndpoint, CopilotAction

# Define your actions
def say_hello(name: str) -> str:
    """Say hello to the user."""
    return f"Hello, {name}!"

actions = [
    CopilotAction(
        name="say_hello",
        description="Say hello to the user",
        handler=say_hello
    )
]

# Create FastAPI app
app = FastAPI()

# Initialize CopilotKit endpoint
ck_endpoint = CopilotKitRemoteEndpoint(
    actions=actions,
    max_workers=10  # Optional thread pool configuration
)

# Add CopilotKit endpoint to FastAPI
add_fastapi_endpoint(app, ck_endpoint, "/copilotkit_remote")

# Run with uvicorn
if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

Frontend Integration

• Connect your frontend to the Python server:

import { CopilotRuntime } from "@copilotkit/runtime";

const runtime = new CopilotRuntime({
  remoteEndpoints: [
    {
      url: "http://localhost:8000/copilotkit_remote"
    }
  ]
});

Key Features

• LangGraph and LangChain Integration: Easy integration with popular Python AI frameworks
• Stateful Conversations: Maintains conversation state across interactions
• Extensible Agent Framework: Build complex AI agents with Python
• FastAPI-Ready Endpoints: Production-ready REST endpoints
• Dynamic Actions: Support for dynamically defined actions and agents

Python Agent Examples

The codebase includes comprehensive Python agent examples that demonstrate running servers and integrating with the LangGraph platform, showing real-world implementations of Python-based CopilotKit runtime servers.

Documentation References:

• Remote Backend Endpoint Guide
• Python SDK Reference

Examples:

• CoAgents Travel Example - Complete Python agent implementation
• Python SDK Documentation - Full SDK details and examples

This Python implementation provides a complete alternative to the Node.js runtime while maintaining full compatibility with CopilotKit's frontend components.

---

Was this helpful?

If this solution worked for you, please click on the appropriate option below to help us improve:

✅ Issue Solved | ❌ Need more help

[NathanTarbert]

Hi @aakashlf, the copilot runtime only works on Node at this time.

[jpr5]

CopilotKit's runtime is Node.js-based, but agent logic runs in Python via LangGraph/PydanticAI/CrewAI connected through remote endpoints or AG-UI. See the coagents docs.