cloudflare/ai

cloudflare/ai

Language: TypeScript

License: MIT

Stars: 1066

Forks: 312

Open issues: 80

Created: 2025-03-14T12:57:48Z

Pushed: 2026-05-13T06:12:38Z

Default branch: main

Fork: no

Archived: no

README:

Cloudflare AI

Packages and examples for building AI-powered applications on Cloudflare. Includes providers for the Vercel AI SDK and TanStack AI, with support for Workers AI and AI Gateway.

Packages

| Package | Description | npm | | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |

Examples

| Example | Description | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [examples/workers-ai](./examples/workers-ai/) | Full-featured Workers AI playground using the Vercel AI SDK. Demonstrates all 6 capabilities: chat (with tool calling and reasoning), image generation, embeddings, transcription, text-to-speech, and reranking. Supports both binding and REST API modes. | | [examples/tanstack-ai](./examples/tanstack-ai/) | Multi-provider demo using TanStack AI. Provider-first UI with Workers AI (binding and gateway), OpenAI, Anthropic, Gemini, Grok, and OpenRouter — each with capability sub-tabs for chat, image, summarize, transcription, and TTS. |

Demos

The [demos/](./demos/) directory contains additional focused demos for specific patterns — tool calling, structured output, agents, MCP servers, and more. See [demos.json](./demos.json) for the full list.

Local Development

# Clone and install
git clone git@github.com:cloudflare/ai.git
cd ai
pnpm install

# Run an example
cd examples/workers-ai
pnpm dev

# Run tests for a package
cd packages/workers-ai-provider
pnpm test

# Run E2E tests (requires Cloudflare credentials)
pnpm test:e2e

Contributing

1. Fork or clone the repo, then pnpm install from the root. 2. Create a branch for your change. 3. If your change affects a published package, run pnpm changeset and describe what changed. 4. Submit a PR to main.

Release Process

This repo uses Changesets. When a PR with changesets merges to main, a "Version Packages" PR is created automatically. Merging that PR bumps versions and publishes to npm.