- Pi 1.5 support: agents/harness/pi, agents/models/pi-ai and the Pi tools now run on Pi 1.5.
- Far fewer storage writes while streaming: Pi stores streamed answers and tool output in batches, at the latest every second, instead of on every update.
- Faster with many sessions: Pi's scheduler no longer rechecks every conversation on each commit, so on SQLite one Pi harness with 2,048 sessions went from 88 to 459 agent runs per second.
- Large answers no longer blow up memory: streaming a 500 KB tool call used to take about 20 s of CPU and a 100 MB heap, and a 140 KB answer followed by a 140 KB tool call held over 100 MB.
- Conversation view: session.watch() replaces session.events(). It returns the newest transcript entries and the session's live state, such as the answer being streamed, running tools, and why the…
- Continue a run: session.continue() starts a run on the transcript as it is, without a new message, for example after the model errored or the run hit its turn limit.
Cloudflare Agents SDK by Cloudflare
Cloudflare's SDK for building stateful agents that run on Workers and Durable Objects. Its optional Pi harness support (Pi Durable) is experimental, and each agents release supports one Pi minor version.
Agent frameworks and SDKs Edge agent SDK
Use it in: API / SDK Works with: MCP Multi-agent
1. Price
The SDK is open source and free; running agents is billed through Cloudflare Workers and Durable Objects usage. As reported on the official pricing page, checked Nov 4, 2026.
4. Development
5 stable releases in the last 30 days, 14 in 90.
github.com/cloudflare/agents/releases/tag/agents%400.33.0Checked Nov 4, 2026. Tap a verdict to see its source.How we checkedReport an error
What Cloudflare Agents SDK does
Cloudflare Agents SDK is an edge agent SDK from Cloudflare. You use it through a TypeScript library. Its documentation covers MCP servers and subagents or parallel agents. It can run models from OpenAI, Anthropic, Google and any OpenAI-compatible endpoint. It is used from TypeScript. It is free and open source (MIT); you pay only for the models it calls.
Usage data: latest readings Nov 17 to Nov 19, 2026, last checked Nov 19, 06:26 UTC. Date of each number
Cloudflare Agents SDK popularity and usage data
Cloudflare Agents SDK was downloaded 3.5M times from npm in the week ending Nov 17, 2026, up 5.9% on the week before and up 51.9% over the last 30 days compared with the 30 before. The GitHub repository has 6,004 stars, 166 of them added in the last 30 days. The latest stable release is 0.33.0, published Nov 3, 2026; there were 5 stable releases in the past 30 days. It was mentioned in 1 Hacker News posts and comments over the last 30 days.
Download the raw daily series: cloudflare-agents.csv
Gid Score breakdown
Gid Score shows public popularity and activity (usage, GitHub stars, mentions, growth), not the quality of the product. Each component is scored 0 to 100 from public signals; a dash means no data for it. How the Gid Score works.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| Package downloads | Nov 17, 2026 | Nov 19, 06:18 UTC |
| GitHub stars | Nov 19, 2026 | Nov 19, 06:26 UTC |
| Hacker News mentions | Nov 18, 2026 | Nov 19, 06:26 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
Pricing
The SDK is open source and free; running agents is billed through Cloudflare Workers and Durable Objects usage.
Checked Nov 4, 2026. Prices change often; confirm before you buy.
Quick answers
- Free to start?Yes
- Open source?Yes (MIT)
- Where you use itTypeScript library
- Supports MCP?Yes
- Model providersopenai, anthropic, google, any OpenAI-compatible
- Subagents / multi-agent?Yes
- Feature comparisonAll agents
- Closest alternativeLangChain · all alternatives
What changed: recent Cloudflare Agents SDK releases
14 stable releases in the last 90 days · Monthly summary · Full changelog
- #2752 34cbd30 Thanks @mattzcarey! - Add experimental_registerOpenTelemetry() to agents/observability, which records spans from OpenTelemetry-instrumented libraries as Workers trace spans.
- #2771 54ae3e8 Thanks @mattzcarey! - Breaking: agents/skills now loads Agent Skills from Computer Workspace files (workspace()), R2 (r2()), or code (manifest()), checks SKILL.md against the Agent…
- #2763 df85805 Thanks @mattzcarey! - Agents SDK spans (agent lifecycle, wrapAISDK, Think) now set span status error on failure, where the Workers runtime supports Span.setStatus().
- #2737 08747d9 Thanks @mattzcarey! - Mark the package side-effect free (apart from the CLI), so bundlers drop the modules a Worker doesn't use.
- #2744 a2d371e Thanks @mattzcarey! - Update @modelcontextprotocol/client and @modelcontextprotocol/server to 2.4.0 and @modelcontextprotocol/sdk to 1.32.2, and add a clientMetadataUrl option to…
- #2740 8cf6da1 Thanks @mattzcarey! - agents/models/pi-ai parses streamed chat-completions tool-call arguments incrementally, instead of re-parsing the whole argument text on every delta.
Earlier releases
- Internal hostnames: pass up to 8 hostnames to browserRun() as internalHosts. Serve each one from a fetch function on your agent or from another Worker. See Internal hostnames.
- Hosts the model points: give a host a target schema, and the model chooses what it serves with browser.assignHost(), such as a container port or a folder in its workspace.
- Lighter installs without MCP servers: @modelcontextprotocol/sdk and @modelcontextprotocol/server are now optional peer dependencies, so apps that don't serve MCP no longer install them.
- Stable models: agents/models/ai-sdk and agents/models/pi-ai are no longer experimental. See Models.
- Other changes: createMcpHandler passes the verified token from @cloudflare/workers-oauth-provider 1.x to tool callbacks as context.http.authInfo.
- browserTool improvements: the model's code runs in its own Dynamic Worker instead of on codemode, and is stopped from outside that Worker if it overruns its timeout.
- #2684 9c79ba1 Thanks @ben-reitz! - Fix PiHarness with onWake not resuming a sleeping Pi task, such as a compaction retry, while another task is running. See How recovery works.
- Pi 1.4 support: agents/harness/pi now runs on Pi 1.4.
- Hibernation while Pi's tasks sleep: PiHarness passes Pi's onWake through your harness factory, so a Durable Object sleeps until Pi's next task is due instead of staying in memory.
- One wake job per object: PiHarness wakes from Pi's wake(), so a task stopped by Pi's restart limit no longer keeps the object awake.
- Parked tasks: tasks stopped by Pi's restart limit show as parked in pending(), and retry() runs them again.
- Recovery: Pi reopens after a storage error instead of failing every call until the object restarts, and the wake job survives failed steps with backoff.
- Fixes: Lifecycle no longer keeps evicted Durable Objects in memory, and it arms a fallback alarm when startup fails.
- #2560 8c720d3 Thanks @mattzcarey! - Agent Skills read and write a @cloudflare/computer Workspace, for both projection and skills.runner(). See Upgrading to a Computer workspace.
- #2584 3b3a88e Thanks @ben-reitz! - Browser creates and closes its Browser Run sessions with the binding's typed acquire() and closeSession(), falling back to the HTTP API in fully local dev.
- #2615 05843e4 Thanks @mattzcarey! - Chat recovery now seals a turn after chatRecovery.maxInterruptedAttempts interrupted attempts (default 5), so a turn that exceeds the Durable Object memory…
- #2604 5d6f5d6 Thanks @mattzcarey! - createAI takes { accountId, apiToken } in place of binding, to use a gateway in another account or to run outside a Worker. See the models docs.
- #2622 2c68a71 Thanks @mattzcarey! - createAI transcribes with @cf/deepgram/nova-3. See the models docs.
- #2576 b048873 Thanks @mattzcarey! - createAI no longer uses AI Gateway's deprecated Universal Endpoint. Model ids, now including catalog ids like anthropic/claude-opus-4.8, run on env.AI.run.
Cloudflare Agents SDK alternatives
Best Cloudflare Agents SDK alternatives compared · All agent frameworks and SDKs
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 |
LangChainLangChain |
79 | 41.1M | up 5.7% | down 2.7% | 150K+76/day | 1.5.22d ago | Free (OSS) | |||
| 2 |
LangGraphLangChain |
75 | 20.1M | up 5.5% | up 29.2% | 45.1K+48/day | 1.2.23yesterday | Free (OSS) | |||
| 3 |
AI SDKVercel |
68 | 47.2M | up 3.9% | up 38.4% | 28.1K+30/day | 7.0.1772d ago | Free (OSS) | |||
| 4 |
Claude Agent SDKAnthropic |
64 | 29.3M | up 5.9% | up 37.6% | 8,588+9/day | 0.2.185yesterday | Free (OSS) | |||
| 5 |
MastraMastra |
63 | 3.7M | up 14.9% | up 49.9% | 29.6K+23/day | 1.84.02d ago | Free (OSS) | |||
| 6 |
OpenAI Agents SDKOpenAI |
62 | 7.2M | up 4.8% | up 38.9% | 30.8K+21/day | 0.25.02d ago | Free (OSS) | |||
Get started with Cloudflare Agents SDK
| npm | npm install agents |
|---|
These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.
Cloudflare Agents SDK FAQ
How much does Cloudflare Agents SDK cost?
The SDK is open source and free; running agents is billed through Cloudflare Workers and Durable Objects usage.
Is Cloudflare Agents SDK open source?
Yes. Cloudflare Agents SDK is open source, released under the MIT license.
How popular is Cloudflare Agents SDK?
Cloudflare Agents SDK was downloaded 3.5M times from npm in the week ending Nov 17, 2026, up 5.9% on the week before and up 51.9% over the last 30 days compared with the 30 before. The GitHub repository has 6,004 stars, 166 of them added in the last 30 days. The latest stable release is 0.33.0, published Nov 3, 2026; there were 5 stable releases in the past 30 days.
What is the latest version of Cloudflare Agents SDK?
The latest stable release we track is 0.33.0, published on Nov 3, 2026.
What are the alternatives to Cloudflare Agents SDK?
The closest alternatives in the same category by Gid Score are LangChain, LangGraph, AI SDK, Claude Agent SDK.
More about Cloudflare Agents SDK
What's new
What's new in Cloudflare Agents SDK: November 2026 so far
November brought performance improvements across streaming and session handling, plus support for Pi 1.5 and new run control features. Memory usage, storage writes, and CPU overhead were all significantly reduced.
- Streaming now uses 100x less memory for large responses by batching storage writes instead of writing on every update.
- Session handling is dramatically faster with many concurrent conversations, reaching 459 agent runs per second on SQLite.
- New session.watch() method replaces session.events() to get live transcript entries and current session state.
- Turn limits now prevent infinite loops, with runs ending cleanly when they hit the maximum tool rounds.
1 release this month · summarised from the official release notes · all months
Articles
AgentGid articles about Cloudflare Agents SDK
Add-ons
Add-ons for Cloudflare Agents SDK: save tokens, add memory and tools
LiteLLM
One gateway for 100+ models with spend tracking, budgets, rate limits and fallbacks.
Langfuse
Traces every model and tool call with its cost and latency, and runs evaluations.
Firecrawl
Turns websites into clean Markdown or structured data the agent can read.
E2B
Runs agent-written code in isolated cloud sandboxes instead of on your machine.
Composio
Connects the agent to 1,000+ apps and APIs with managed sign-in.
Mem0
Adds long-term memory, so the agent remembers users and past work across sessions.
Listed because each tool documents support for Cloudflare Agents SDK or for agent frameworks in general. Savings and results depend on your workload.
Used with it
Tools used with Cloudflare Agents SDK
What 37 public GitHub projects that depend on Cloudflare Agents SDK use with it, from their dependency files.
- Zod94.6%
- TypeScript89.2%
- Wrangler89.2%
- Model Context Protocol SDK (JavaScript)56.8%
- Cloudflare Workers Types56.8%
- AI SDK51.4%
- Vitest51.4%
- React45.9%
- Tailwind CSS40.5%
- Hono40.5%
Used far more often here than in AI-built projects overall: what sets Cloudflare Agents SDK projects apart.
- Workers AI provider32.4% · 338.1×
- Cloudflare Agents AI Chat18.9% · 197.2×
- OpenAI Agents SDK (JavaScript)16.2% · 126.8×
- Vitest Pool Workers21.6% · 112.7×
- Scalar API Reference13.5% · 84.5×
- assistant-ui13.5% · 84.5×
- @cloudflare/vite-plugin24.3% · 56.3×
- Phosphor Icons10.8% · 25.0×
Ratings
Ratings from people who use Cloudflare Agents SDK
No ratings yet. Used Cloudflare Agents SDK? Rate it and say what it is good and bad at.
Price history
Cloudflare Agents SDK prices over time
Sources
For the makers of Cloudflare Agents SDK badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/cloudflare-agents/)
[](https://agentgid.com/agents/cloudflare-agents/)
[](https://agentgid.com/agents/cloudflare-agents/)
Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
npm: agents. GitHub: cloudflare/agents. See data sources for how each one is collected.