cf-agents

^{Cloudflare Agents for Python Workers}

Features

• Typed, async-first Python 3.12+
• FFI Handling under the hood. Just write Python, we handle talking to the runtime.
• Behavioural and API parity with the TypeScript Agents SDK.

Installing

It's recommended you use uv - you'll need to use pywrangler to deploy to Cloudflare.

$ uvx --from workers-py pywrangler init
$ uv add cf-agents

Quickstart

The Agent class gives you the core tools to build stateful, durable agents.

from agents import Agent, callable, route_agent_request
from workers import WorkerEntrypoint, Response

from utils import google_search

class LunchAgent(Agent):
    initial_state = {"votes": {}}

    @callable
    async def search_restaurants(self) -> list[str]:
        restaurants: list[str] = await google_search(
            "Korean BBQ places near County Hall"
        )
        return restaurants

    @callable
    async def vote(self, person: str, restaurant: str):
        votes = self.state["votes"]
        votes[person] = restaurant
        self.set_state(self.state)


class Default(WorkerEntrypoint):
    async def fetch(self, request) -> Response:
        response = await route_agent_request(request, self.env)
        return response or Response("Not Found", status=404)

It can get tedious implementing similar patterns for chat agents over and over again. See AIChatAgent.

Links

• Documentation
• Crosswind