bolt.diy

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 22+ 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. OpenRouter, Anthropic, OpenAI, and Google are enabled by default; enable and configure other providers in Settings.

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!

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!

Table of Contents

• Quick Start
• Running with Docker
• Desktop App (Electron)
• Configuring API Keys and Providers
• Features
• Recent Highlights
• Available Scripts
• Contributing & Community
• Licensing

Quick Start

Prerequisites

• Node.js >= 22.12.0
• pnpm >= 9.15.9 (npm install -g pnpm)

1. Clone & Install

git clone https://github.com/stackblitz-labs/bolt.diy.git
cd bolt.diy
pnpm install

2. Run the Development Server

pnpm run dev

Open 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.

Running with Docker

1. Configure Environment Variables:

   cp .env.example .env.local
   

2. Build and Run:

   # Development mode with hot-reload:
   docker compose --profile development up
   
   # Production build:
   pnpm run dockerbuild:prod
   docker compose --profile production up
   

Desktop App (Electron)

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
  

Configuring API Keys and Providers

You can configure model providers either directly in the UI or via environment variables:

Option A: In the UI (Recommended)

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.

Option B: Environment Variables

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

Features

• In-Browser Web Development: Full-stack Node.js development environment powered by WebContainers.
• 22+ AI Providers: Cloud (Anthropic, OpenAI, Google, DeepSeek, Groq, xAI, Mistral, etc.) and Local (Ollama, LM Studio). OpenRouter, Anthropic, OpenAI, and Google are enabled by default.
• Interactive Workbench: Integrated code editor, terminal, visual diff viewer, and real-time live preview. Opens by default for a started chat and can be reopened after closing.
• Starter Setup: Explicit framework requests select a matching starter in code. Starter files include detected install and development server commands before the first customization request.
• Prompt Library: Choose a system prompt under Settings → Workspace → Features, including Simple Sal for concise guidance and Tiny Tim for smaller models.
• 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.

Recent Highlights

• Expanded AI & Tooling Ecosystem: 22+ 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.
• Prompt and Connector Controls: Select MCP tools from the prompt attachment menu; manage GitHub, GitLab, Netlify, and other service connections under Settings → Integrations → Connectors.

Looking Ahead: Ongoing work includes bug Fixes, dependance updates and fixes for reliability issues no new features are planed.

Available Scripts

Contributing & Community

• 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.

Licensing

bolt.diy is open-source under the MIT License. It utilizes the WebContainers API, which has specific commercial licensing terms for enterprise deployment.