Welcome to bolt.diy, the open-source AI developer workspace that lets you select your preferred LLM for every prompt. Build full-stack web applications in the browser with support for 21+ model providers (OpenAI, Anthropic, Gemini, Groq, xAI, DeepSeek, Ollama, LM Studio, and more), or extend it with any provider supported by the Vercel AI SDK.
Documentation | Community Forum | FAQ & Troubleshooting
Also this pinned post in our community has a bunch of incredible resources for running and deploying bolt.diy yourself!
We have also launched an experimental agent called the "bolt.diy Expert" that can answer common questions about bolt.diy. Find it here on the oTTomator Live Agent Studio.
bolt.diy was originally started by Cole Medin but has quickly grown into a massive community effort to build the BEST open source AI coding assistant!
- Quick Start
- Running with Docker
- Desktop App (Electron)
- Configuring API Keys and Providers
- Features
- Recent Highlights
- Available Scripts
- Contributing & Community
- Licensing
- Node.js >= 22.12.0
- pnpm >= 9.15.9 (
npm install -g pnpm)
git clone https://github.com/stackblitz-labs/bolt.diy.git
cd bolt.diy
pnpm installpnpm run devOpen http://localhost:5173 in your browser.
Pre-built Desktop Binaries: Prefer a standalone app? Download binaries for Windows, macOS, and Linux from our Latest Releases.
-
Configure Environment Variables:
cp .env.example .env.local
-
Build and Run:
# Development mode with hot-reload: docker compose --profile development up # Production build: pnpm run dockerbuild:prod docker compose --profile production up
bolt.diy is also available as a cross-platform desktop application:
- Download: Grab pre-built installers from Latest Releases.
- Build from Source:
pnpm electron:build:dist
You can configure model providers either directly in the UI or via environment variables:
Click the Settings icon (⚙️) in the sidebar → Providers. Enter your API keys or configure local endpoints (Ollama, LM Studio, OpenAI-compatible). Keys are validated in real time and stored securely in your browser cookies.
Copy .env.example to .env.local and add your keys or local endpoints:
# Cloud Providers
ANTHROPIC_API_KEY=your_key_here
OPENAI_API_KEY=your_key_here
GEMINI_API_KEY=your_key_here
# Local Providers
OLLAMA_BASE_URL=http://127.0.0.1:11434
LMSTUDIO_BASE_URL=http://127.0.0.1:1234- In-Browser Web Development: Full-stack Node.js development environment powered by WebContainers.
- 21+ AI Providers: Cloud (Anthropic, OpenAI, Google, DeepSeek, Groq, xAI, Mistral, etc.) and Local (Ollama, LM Studio).
- Interactive Workbench: Integrated code editor, terminal, visual diff viewer, and real-time live preview.
- Project Workflows: Git cloning/pushing, snapshot restoration, file conflict locking, and ZIP export.
- Deployments: One-click deployment to Netlify, Vercel, and GitHub Pages.
- Database & Visuals: Supabase integration, data visualization charts, and Model Context Protocol (MCP) tooling.
- ⚡ Performance Optimized: 3x faster with Claude.dev-inspired optimizations. See PERFORMANCE.md for details.
- Expanded AI & Tooling Ecosystem: 21+ cloud and local LLM providers, Model Context Protocol (MCP) integration, and voice prompting.
- Enhanced Code & Project Workflows: Visual diff inspection, file conflict locking, codebase search, Git integration, and snapshot restoration.
- Cross-Platform & Deployments: Native Electron desktop app, Expo (React Native) support, and direct deployment to Netlify, Vercel, and GitHub Pages.
- Data & Backend Integrations: Built-in Supabase management, interactive charts, and bulk chat operations.
Looking Ahead: Ongoing work includes multi-agent architectures, model prompt workstyle optimizations, and deeper editor workflows. Track upcoming milestones on our Roadmap.
| Command | Description |
|---|---|
pnpm run dev |
Start development server with hot module reloading |
pnpm run build |
Build the application for production (react-router build) |
pnpm run preview |
Preview production build locally |
pnpm test |
Run unit and integration tests with Vitest |
pnpm run typecheck |
Run TypeScript type checks (tsc) |
pnpm run lint |
Run ESLint across the codebase |
pnpm run dockerbuild |
Build Docker container for development |
pnpm run electron:dev |
Start Electron desktop application in dev mode |
pnpm electron:build:dist |
Package Electron desktop app for current OS |
- Contributing: Contributions are welcome! Read our Contributing Guide and Project Management Guide to get started.
- Troubleshooting & FAQ: Common errors and setup fixes are documented in our FAQ and Official Docs.
- Community: Join conversations and tutorials in the oTTomator Think Tank.
bolt.diy is open-source under the MIT License. It utilizes the WebContainers API, which has specific commercial licensing terms for enterprise deployment.
