# cloudflare/agents

Build and deploy AI Agents on Cloudflare

Repository: https://github.com/cloudflare/agents
Canonical: https://ross.abutalabs.com/products/cloudflare-agents
Homepage: https://developers.cloudflare.com/agents/
Language: TypeScript
License: MIT
License Family: permissive
Topics: agents, ai, cloudflare, durable-objects, workflows
Last push: 2026-08-26T20:27:44+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 41
- inputs: {"age_days": 581, "days_push": 7, "days_rel": 15, "gap_med": 0.0, "n_releases_24m": 373}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5490, forks 684 (observed 2026-08-28T04:09:19.772840+00:00)

## What it is
A TypeScript SDK for building persistent, stateful AI agents on Cloudflare Workers, powered by Durable Objects. Each agent gets durable identity, SQLite storage, real-time WebSocket connections, scheduling, and built-in MCP support, scaling to millions of hibernating instances.

## Use cases
- build a chatbot with persistent memory on Cloudflare
- deploy stateful AI agents that scale per user or session
- add real-time state sync between server and React frontend
- connect agents to MCP tools and workflows
- schedule background tasks inside an agent runtime
- build voice, email, or Slack-connected agents

## When to choose
- you are already on Cloudflare Workers and want durable, stateful agent infrastructure
- you need agents that hibernate when idle and scale to millions of instances
- you want built-in WebSockets, scheduling, storage, and MCP in one SDK

## When to avoid
- you need to self-host outside Cloudflare's platform
- you want a provider-agnostic agent framework that runs on any cloud or VM
- your workload requires long-running processes beyond Workers execution limits

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, websocket, mcp, scheduling, state-management, sdk
- domain: large-language-models, cloud-computing, developer-tools
- platform: serverless
- tags: durable-objects, cloudflare-workers, serverless-agents, react-bindings, real-time-sync, ai-agents, real-time, cloudflare, typescript, nodejs, web-server

## Member repositories
- cloudflare/agents (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:19.772840+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:56:20.902729+00:00, confidence not recorded.
  - readme: https://github.com/cloudflare/agents (fetched 2026-08-28T04:09:19.772840+00:00, sha 6acf8fd97d9f)
  - homepage: https://developers.cloudflare.com/agents/ (fetched 2026-08-29T08:51:51.862619+00:00, sha a205f9550522)
  - site_page: https://developers.cloudflare.com/agents/getting-started/quick-start (fetched 2026-08-29T08:51:51.876645+00:00, sha 23ae4e489376)
  - site_page: https://developers.cloudflare.com/agents/getting-started/add-to-existing-project (fetched 2026-08-29T08:51:51.878791+00:00, sha 4720b4cf867c)
  - site_page: https://developers.cloudflare.com/agents/getting-started/testing-your-agent (fetched 2026-08-29T08:51:51.880827+00:00, sha 612b1d5ce776)
  - site_page: https://developers.cloudflare.com/agents/harnesses/think/getting-started (fetched 2026-08-29T08:51:51.882817+00:00, sha 95339daabf02)
  - site_page: https://developers.cloudflare.com/ (fetched 2026-08-29T08:51:51.871765+00:00, sha 1b8430a97c92)
  - site_page: https://developers.cloudflare.com/changelog (fetched 2026-08-29T08:51:51.874110+00:00, sha d22a1e616fbf)
- Data as of 2026-08-30T08:39:29.467469+00:00.