# workers-go

> Run HTTP servers written in Go on Cloudflare Workers and in the browser.

## Docs

- [Introduction](https://workers-go.syumai.dev/introduction): workers-go is a Go module that runs an HTTP server written in Go on Cloudflare Workers, Neon Functions, Deno, and in the browser.
- [Quickstart](https://workers-go.syumai.dev/quickstart): Create a workers-go project from the Cloudflare template, run it locally, and deploy it.
- [FAQ](https://workers-go.syumai.dev/faq): Frequently asked questions about workers-go.

## Cloudflare

- [Cloudflare](https://workers-go.syumai.dev/cloudflare): Run an http.Handler on Cloudflare Workers and Pages Functions, and bind Workers platform features to your Go code.
- [Environment variables](https://workers-go.syumai.dev/cloudflare/environment-variables): Read environment variables and arbitrary bindings declared in wrangler.toml from Go.
- [KV](https://workers-go.syumai.dev/cloudflare/kv): Read, write, list, and delete keys in a Cloudflare Workers KV namespace from Go.
- [R2](https://workers-go.syumai.dev/cloudflare/r2): Store and serve objects in a Cloudflare R2 bucket with Head, Get, Put, Delete, and List.
- [D1](https://workers-go.syumai.dev/cloudflare/d1): Query a Cloudflare D1 database from Go through the standard database/sql interface.
- [Cache API](https://workers-go.syumai.dev/cloudflare/cache): Cache HTTP responses in the Cloudflare data center with the Cache API.
- [Durable Objects](https://workers-go.syumai.dev/cloudflare/durable-objects): Host a Go type as a Durable Object class, and call Durable Object stubs from a Go worker.
- [Queues](https://workers-go.syumai.dev/cloudflare/queues): Produce messages to and consume messages from Cloudflare Queues in Go.
- [Cron Triggers](https://workers-go.syumai.dev/cloudflare/cron): Run Go tasks on a schedule with Cloudflare Cron Triggers.
- [FetchEvent](https://workers-go.syumai.dev/cloudflare/fetch-event): Extend the lifetime of a fetch event with waitUntil and passThroughOnException.
- [Outbound fetch](https://workers-go.syumai.dev/cloudflare/fetch): Make outbound HTTP requests, call other workers through Service Bindings, and read incoming request properties.
- [TCP Sockets](https://workers-go.syumai.dev/cloudflare/sockets): Open outbound TCP connections from a worker with the sockets API.
- [Pages Functions](https://workers-go.syumai.dev/cloudflare/pages-functions): Serve dynamic routes on Cloudflare Pages with a Go Wasm function.
- [Workers AI](https://workers-go.syumai.dev/cloudflare/ai): Run Workers AI models — text generation, streaming, and text embeddings — from Go.
- [Analytics Engine](https://workers-go.syumai.dev/cloudflare/analytics): Write data points to a Workers Analytics Engine dataset from Go.
- [Request metadata (request.cf)](https://workers-go.syumai.dev/cloudflare/cf): Read Cloudflare edge request metadata — colo, country, ASN, TLS info — from request.cf.
- [Dynamic dispatch](https://workers-go.syumai.dev/cloudflare/dispatch): Invoke customer workers in a Workers for Platforms dispatch namespace.
- [Email Workers](https://workers-go.syumai.dev/cloudflare/email): Receive inbound mail via Email Routing and send outbound mail from a Go worker.
- [Hyperdrive](https://workers-go.syumai.dev/cloudflare/hyperdrive): Connect to Postgres and MySQL through Cloudflare Hyperdrive using database/sql drivers.
- [Images](https://workers-go.syumai.dev/cloudflare/images): Transform and optimize images with the Cloudflare Images binding.
- [Rate Limiting](https://workers-go.syumai.dev/cloudflare/ratelimit): Enforce rate limits from a worker with the Rate Limiting binding.
- [Secrets Store](https://workers-go.syumai.dev/cloudflare/secretsstore): Read account-level secrets from the Cloudflare Secrets Store.
- [Tail Workers](https://workers-go.syumai.dev/cloudflare/tail): Consume another Worker's execution traces from Go with a Tail Worker.
- [Vectorize](https://workers-go.syumai.dev/cloudflare/vectorize): Query and mutate a Cloudflare Vectorize index from Go.
- [Worker Versions](https://workers-go.syumai.dev/cloudflare/versions): Read version metadata (id, tag, timestamp) of the running worker version.
- [WebSocket](https://workers-go.syumai.dev/cloudflare/websocket): Accept server-side WebSocket connections in a Go worker.
- [Workflows](https://workers-go.syumai.dev/cloudflare/workflows): Create and manage Cloudflare Workflows instances from Go.
- [RPC and named entrypoints](https://workers-go.syumai.dev/cloudflare/rpc): Call and host Cloudflare Workers RPC methods on named WorkerEntrypoints from Go.
- [Hono middleware](https://workers-go.syumai.dev/cloudflare/hono): Write Hono middleware in Go with the experimental exp/hono package.
- [Generated bindings (exp/cloudflare)](https://workers-go.syumai.dev/cloudflare/generated-bindings): How the exp/cloudflare Go bindings are mechanically generated from @cloudflare/workers-types.
- [Build and deploy](https://workers-go.syumai.dev/cloudflare/build): How the Go-to-Wasm build pipeline works — workers-assets-gen, wasm_exec.js, and wrangler.

## Browser

- [Browser](https://workers-go.syumai.dev/browser): Run a Go HTTP server inside a browser tab with the browser-go template.

## Neon Functions

- [Neon Functions](https://workers-go.syumai.dev/neon): Run a Go HTTP server on Neon Functions with the functions-tinygo template.

## Deno / Deno Deploy

- [Deno / Deno Deploy](https://workers-go.syumai.dev/deno): Run a Go HTTP server on Deno and Deno Deploy with the worker-go template.

## Agent resources

- [llms-full.txt](https://workers-go.syumai.dev/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://workers-go.syumai.dev/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://workers-go.syumai.dev/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://workers-go.syumai.dev/openapi.json.
- [API catalog](https://workers-go.syumai.dev/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://workers-go.syumai.dev/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://workers-go.syumai.dev/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://workers-go.syumai.dev/sitemap.xml): Every indexable page URL with its last-modified date.