alchemy-run / alchemy

**Infrastructure-as-Effects** — cloud infrastructure and application logic as a single, type-safe Effect program.
Docs · Tutorial · Examples · Discord
---
An R2 Bucket, and a Worker that serves files from it:
 [code] 
One `ReadWriteBucket(Uploads)` call adds the Worker binding at deploy time and hands back a typed client at runtime.
---
- **One program, one language.** Resources, Lambdas/Workers, IAM, and SDKs live in the same Effect program — no YAML, no second runtime.
- **Bindings, not glue code.** `AWS.S3.GetObject(bucket)` wires the IAM policy, env var, and a typed SDK call in a single line.
- **Errors in the type system.** Every cloud API failure is a tagged Effect error you handle — or don't — on purpose.
- **Many clouds, one model.** AWS, Cloudflare, GCP, Fly, Hetzner, Kubernetes, Railway, Neon, PlanetScale, Stripe, and more.
- **Same code, every stage.** Local dev, `plan` / `deploy`, smoke tests, and CI all share one mental model.
 [code] 
## GitHub Action
Use the root action to deploy `prod` from `main`, deploy PR previews as
`staging-{number}`, and destroy PR previews when the PR closes:
 [code] 
The workflow must install the `alchemy` CLI before this action runs.
## Bootstrap with an AI coding agent
Paste this into Claude Code, Cursor, or any agent that can fetch a URL:
 [code] 
## Learn more
- What is Alchemy? — the framework in 2 minutes
- Getting Started — your first Stack
- Tutorial — build, test, and deploy a Cloudflare app step by step
- Examples — runnable projects on AWS and Cloudflare
- llms.txt — agent-ready documentation index
> **alchemy** v2 is in beta. Expect breaking changes. Come hang in our Discord.
## Credits
### Blacksmith
Thanks to Blacksmith for sponsoring our CI runners. Their fast Linux, macOS, and Windows runners help us test our packages across platforms and deploy our content-heavy website in mere minutes.
## License
Licensed under the Apache License 2.0. See
Third-Party Licenses for code incorporated from
upstream projects.