Agents Starter

Agent Starter


A starter template for building AI chat agents on Cloudflare, powered by the [Agents SDK](https://developers.cloudflare.com/agents/).

Uses Workers AI (no API key required), with tools for weather, timezone detection, calculations with approval, task scheduling, and vision (image input).

Quick start

npx create-cloudflare@latest --template cloudflare/agents-starter
cd agents-starter
npm install
npm run dev

**Cloudflare authentication is required to run locally.** This template uses Workers AI with `"ai": { "remote": true }` in `wrangler.jsonc`, and Workers AI has no local simulator — so `npm run dev` opens a remote proxy session against Cloudflare and needs you to be authenticated. Either run `wrangler login` once in an interactive terminal, or set a `CLOUDFLARE_API_TOKEN` environment variable (e.g. in a `.env` file). No third-party (OpenAI/Anthropic) key is needed, but a Cloudflare login is.

Open [http://localhost:5173](http://localhost:5173) to see your agent in action.

Try these prompts to see the different features:

• "What's the weather in Paris?" — server-side tool (runs automatically)
• "What timezone am I in?" — client-side tool (browser provides the answer)
• "Calculate 5000 * 3" — approval tool (asks you before running)
• "Remind me in 5 minutes to take a break" — scheduling
• Drop an image and ask "What's in this image?" — vision (image understanding)

Project structure

src/
  server.ts    # Chat agent with tools and scheduling
  app.tsx      # Chat UI built with Kumo components
  client.tsx   # React entry point
  styles.css   # Tailwind + Kumo styles

What's included

• AI Chat — Streaming responses powered by Workers AI via `AICh