Reading the repo

Opening the box…

How to set up dyad (dyad-sh/dyad) · gitmanual

Assembly instructions

dyad-sh/dyad

Local, open-source AI app builder for power users ✨ v0 / Lovable / Replit / Bolt alternative 🌟 Star if you like it!

Node.jsVite#ai-app-builder#anthropic#artificial-intelligence#bolt

Difficulty: Moderate
Time: about 15 min
Stars: ★ 22,186
Activity: Updated this month
License: Not detected
Open issues: 355
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Start here

Website ↗dyad.shThe project's own site.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

Download for macOS

v1.22.0 · 11/2/2026 ↗

dyad-darwin-arm64-1.22.0.zip

zip · Apple Silicon · 130.6 MB · 7,667 downloads · best match

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/dyad-sh/dyad/releases/download/v1.22.0/dyad-darwin-arm64-1.22.0.zip"
unzip "dyad-darwin-arm64-1.22.0.zip"

Other macOS downloads (1)

dyad-darwin-x64-1.22.0.zip

zip · Intel · 140.2 MB · 1,820 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/dyad-sh/dyad/releases/download/v1.22.0/dyad-darwin-x64-1.22.0.zip"
unzip "dyad-darwin-x64-1.22.0.zip"

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 12 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js >=24 <26runtime
1×npm package manager
1×PostgreSQL service

11× settings in .env

OPENAI_API_KEYsecret
ANTHROPIC_API_KEYsecret
GOOGLE_API_KEYsecret
OLLAMA_HOST
GITHUB_CLIENT_ID
GITHUB_CLIENT_SECRETsecret
GITHUB_TOKENsecret
APPLE_ID
APPLE_PASSWORDsecret
APPLE_TEAM_ID
SM_CODE_SIGNING_CERT_SHA1

Share this manual

Good to know

Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Tool versions pinned in mise.toml — mise install (or asdf install) installs them all.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: benchmarks/app-builder/cuj-tests/package.json, benchmarks/app-builder/neon-sim/package.json, benchmarks/app-builder/template/nextjs/package.json, e2e-tests/fixtures/import-app/astro/package.json and 11 more

package.json scripts (48)

bumpnode scripts/bump-version.mjs
cleanrimraf out scaffold/node_modules
startnode scripts/start-supervisor.mjs
start:onboardingnode scripts/start-onboarding.mjs
start:out-of-quotacross-env NODE_ENV=development DYAD_SIMULATE_FREE_AGENT_QUOTA_EXCEEDED=true npm start
copy-data-to-devnode scripts/copy-data-to-dev.mjs
start:expired-subnode scripts/start-subscription-status.mjs payment_past_due
start:ending-subnode scripts/start-subscription-status.mjs subscription_ending
start:paused-subnode scripts/start-subscription-status.mjs subscription_paused
start:healthy-subnode scripts/start-subscription-status.mjs healthy
devcross-env NODE_ENV=development npm start
dev:enginecross-env DYAD_ENGINE_URL=http://localhost:8080/v1 npm start
staging:enginecross-env DYAD_ENGINE_URL=https://staging---dyad-llm-engine-kq7pivehnq-uc.a.run.app/v1 npm start
packagenpm run rebuild:keychain-reader && npm run clean && electron-forge package
makenpm run rebuild:keychain-reader && npm run clean && electron-forge make
publishnpm run rebuild:keychain-reader && npm run clean && electron-forge publish
rebuild:keychain-readernode scripts/rebuild-keychain-reader.mjs
verify-releasenode scripts/verify-release-assets.js
tsnpm run ts:main && npm run ts:workers
ts:mainnpx tsgo -p tsconfig.app.json --noEmit --incremental
ts:workersnpm run ts:workers:code-explorer && npm run ts:workers:supabase-dependency-analysis
ts:workers:code-explorernode node_modules/typescript/bin/tsc -p workers/code_explorer/tsconfig.json --noEmit --incremental
ts:workers:supabase-dependency-analysisnode node_modules/typescript/bin/tsc -p workers/supabase_dependency_analysis/tsconfig.json --noEmit --incremental
lintnpx oxlint --fix
lint:fixnpx oxlint --fix --fix-suggestions --fix-dangerously

Files we read (12)

.devcontainer/devcontainer.json

.env.example

.github/workflows/cancel-ci-after-merge.yml

.github/workflows/cancel-claude-pr-review-after-merge.yml

.github/workflows/ci.yml

.github/workflows/cla.yml

.github/workflows/claude-check-workflows.yml

.github/workflows/claude-deflake-e2e.yml

CONTRIBUTING.md

README.md

mise.toml

package.json

Branch main · 4,027 files in the repo