Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

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

DocsGitHub

Checked 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.

Popularity
#13 in Frameworks
Gid Score 54 / 100 · #13 of 50 ranked frameworks and SDKs
Trend
Growing fast
downloads up 51.9% over 30 days · up 5.9% last week
Community
6,004 GitHub stars
3.5M package downloads a week

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.

Downloads per daynpm, 7-day average 495K/day
GitHub starsrunning total 6,004
Hacker News mentionsposts and comments, rolling 7-day total 0 this week

Download the raw daily series: cloudflare-agents.csv

Gid Score breakdown

Adoption79
Community32
Attention0
Momentum76

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

NumberLatest readingLast checked
Package downloadsNov 17, 2026Nov 19, 06:18 UTC
GitHub starsNov 19, 2026Nov 19, 06:26 UTC
Hacker News mentionsNov 18, 2026Nov 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.

Compare prices of all agents

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

0.33.0
  • 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.
0.32.0
  • #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
0.31.0
  • 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.
0.30.1
  • #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.
0.30.0
  • 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.
0.29.0
  • #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.

Compare Cloudflare Agents SDK with another agent

vs
# 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 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 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

npmnpm 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

Full monthly summary

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
Add-ons

Add-ons for Cloudflare Agents SDK: save tokens, add memory and tools

All agent tooling

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

All tools

What 37 public GitHub projects that depend on Cloudflare Agents SDK use with it, from their dependency files.

  1. Zod94.6%
  2. TypeScript89.2%
  3. Wrangler89.2%
  4. Model Context Protocol SDK (JavaScript)56.8%
  5. Cloudflare Workers Types56.8%
  6. AI SDK51.4%
  7. Vitest51.4%
  8. React45.9%
  9. Tailwind CSS40.5%
  10. Hono40.5%

Used far more often here than in AI-built projects overall: what sets Cloudflare Agents SDK projects apart.

  1. Workers AI provider32.4% · 338.1×
  2. Cloudflare Agents AI Chat18.9% · 197.2×
  3. OpenAI Agents SDK (JavaScript)16.2% · 126.8×
  4. Vitest Pool Workers21.6% · 112.7×
  5. Scalar API Reference13.5% · 84.5×
  6. assistant-ui13.5% · 84.5×
  7. @cloudflare/vite-plugin24.3% · 56.3×
  8. 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

Token prices of OpenAI modelsnewest OpenAI model in each family, output price per 1M tokens
OpenAI FlagshipOpenAI Mini
Sources
For the makers of Cloudflare Agents SDK badges, corrections

Add a live badge to your README or site:

AgentGid: #13 in Frameworks Gid Score: 54/100 downloads: 3.5M/week ▲52% 30d

[![AgentGid: #13 in Frameworks](https://agentgid.com/badges/cloudflare-agents-rank.svg)](https://agentgid.com/agents/cloudflare-agents/)
[![Gid Score: 54/100](https://agentgid.com/badges/cloudflare-agents-score.svg)](https://agentgid.com/agents/cloudflare-agents/)
[![downloads: 3.5M/week ▲52% 30d](https://agentgid.com/badges/cloudflare-agents-downloads.svg)](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.