# Alchemy

Infrastructure as Effects

Repository: https://github.com/alchemy-run/alchemy
Canonical: https://ross.abutalabs.com/products/alchemy
Homepage: https://alchemy.run
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: alchemy, cloud, effect, iac, typescript
Last push: 2026-09-03T01:19:42+00:00
Link (homepage): https://alchemy.run
Link (site_page): https://alchemy.run/getting-started

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 88, longevity 22
- inputs: {"age_days": 315, "days_push": 0, "days_rel": 2, "gap_med": 0, "n_releases_24m": 64}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1162, forks 164 (observed 2026-09-03T02:15:08.932086+00:00)

## What it is
Alchemy is a TypeScript-native Infrastructure-as-Code library for defining cloud resources (e.g., Cloudflare Workers, R2 buckets, Durable Objects) as memoized async functions that are created, updated, and deleted automatically. It runs in any JavaScript runtime with no external service, storing state locally and supporting an AI-first, embeddable workflow.

## Use cases
- provision cloudflare workers and r2 buckets from typescript
- infrastructure as code without yaml or hcl
- deploy a fullstack app to cloudflare with a single script
- create ephemeral preview environments per pull request
- define custom cloud resources as async functions
- manage cloud infrastructure state locally in git
- let an llm agent scaffold and deploy cloud resources

## When to choose
- you want IaC in pure TypeScript with no second language or external engine
- you primarily deploy to Cloudflare or JavaScript-friendly runtimes
- you want embeddable provisioning inside apps, tests, or serverless workflows
- you prefer local state files over a hosted state service

## When to avoid
- you need mature multi-cloud provider coverage like Terraform offers
- your team relies on declarative HCL/YAML workflows and existing Terraform modules
- you require long-term stability guarantees - the project is in beta (v2.0.0-beta)

## Facets
- artifact type: library
- maturity: active
- function: infrastructure-as-code, deployment, developer-tools, configuration-management, sdk
- domain: infrastructure-as-code, cloud-computing, web-development, developer-tools
- platform: bun, cloud, cli, cross-platform
- tags: iac, cloudflare, typescript-native, esm, serverless, provisioning, effect, ai-first, devops, typescript, nodejs

## Member repositories
- alchemy-run/alchemy (main) score 80
- alchemy-run/alchemy-async (mirror) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:08.932086+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-30T02:46:03.371493+00:00, confidence not recorded.
  - readme: https://github.com/alchemy-run/alchemy (fetched 2026-09-03T02:15:08.932086+00:00, sha dccc7dcf9560)
  - homepage: https://alchemy.run (fetched 2026-08-29T10:26:59.485948+00:00, sha 273442b9f826)
  - site_page: https://alchemy.run/getting-started (fetched 2026-08-29T10:26:59.495447+00:00, sha c0aa328c8b67)
- Data as of 2026-08-30T08:39:29.467469+00:00.
