Getting started

Get a cinderworks workshop running locally. You'll need Bun and a model key.

bun create cinderworks@latest my-shop
cd my-shop && bun dev

Once it's up, open the dashboard and start your first chat — tool calls stream in real time.

Tip

Set E2B_API_KEY to enable the Python executor and inline chart rendering.

Note

The dev server runs on the Bun runtime by default. Use bun run dev:node to fall back to Node if you hit a runtime quirk.

Warning

A fresh Postgres volume is migrated automatically at boot, but an existing database must be stamped once before it will accept the migration chain.

Caution

Never commit .env or *.pem files — secrets live in the deploy console, not the repo.