bolt.diy（原名 oTToDev）

欢迎来到 bolt.diy！它是 Bolt.new 的官方开源版本（此前称为 oTToDev 或 bolt.new ANY LLM），你可以自由选择每次调用所使用的 LLM（大语言模型）。目前，bolt.diy 支持 OpenAI、Anthropic、Ollama、OpenRouter、Gemini、LMStudio、Mistral、xAI、HuggingFace、DeepSeek 以及 Groq 等模型，并且基于 Vercel AI SDK 可以轻松拓展到更多模型。请参阅下文了解如何在本地运行和扩展更多模型。

可以查看 bolt.diy 文档获取更多信息。

也可以参考我们社区的这条置顶帖子，其中包含许多关于如何自行运行和部署 bolt.diy 的实用资源。

我们还发布了一个名为 “bolt.diy Expert” 的实验性代理，可用于解答关于 bolt.diy 的常见问题。你可以在 oTTomator Live Agent Studio 上找到它。

bolt.diy 最初由 Cole Medin 发起，但很快便发展成为一个庞大的社区协作项目，致力于打造最出色的开源 AI 编程助手！

---

加入社区（Join the Community）

点击此处加入 oTTomator Think Tank 中的 bolt.diy 社区

---

需求功能（Requested Additions）

• ✅ OpenRouter 集成（@coleam00）
• ✅ Gemini 集成（@jonathands）
• ✅ 自动生成 Ollama 模型（基于已有下载）（@yunatamos）
• ✅ 根据提供方过滤模型（@jasonm23）
• ✅ 下载项目为 ZIP（@fabwaseem）
• ✅ 改进 app\lib\.server\llm\prompts.ts 中主提示信息（@kofi-bhr）
• ✅ DeepSeek API 集成（@zenith110）
• ✅ Mistral API 集成（@ArulGandhi）
• ✅ “Open AI Like” API 集成（@ZerxZ）
• ✅ 将文件同步（单向同步）到本地文件夹（@muzafferkadir）
• ✅ 使用 Docker 容器化该应用，便于安装（@aaronbolton）
• ✅ 直接将项目发布到 GitHub（@goncaloalves）
• ✅ 在 UI 中输入 API Key（@ali00209）
• ✅ xAI Grok Beta 集成（@milutinke）
• ✅ LM Studio 集成（@karrot0）
• ✅ HuggingFace 集成（@ahsan3219）
• ✅ Bolt 终端：查看 LLM 执行命令的输出（@thecodacus）
• ✅ 流式显示代码输出（@thecodacus）
• ✅ 代码回退到早期版本（@wonderwhy-er）
• ✅ 聊天记录的备份与恢复（@sidbetatester）
• ✅ Cohere 集成（@hasanraiyan）
• ✅ 动态模型的最大 token 长度（@hasanraiyan）
• ✅ 更优的提示增强（@SujalXplores）
• ✅ 提示缓存（@SujalXplores）
• ✅ 将本地项目加载到应用中（@wonderwhy-er）
• ✅ Together 集成（@mouimet-infinisoft）
• ✅ 移动端适配（@qwikode）
• ✅ 更优的提示增强（@SujalXplores）
• ✅ 在提示中附加图片（@atrokhym）
• ✅ 添加 Git Clone 按钮（@thecodacus）
• ✅ 从 URL 导入 Git（@thecodacus）
• ✅ PromptLibrary：针对不同使用场景提供多种提示模版（@thecodacus）
• ✅ 检测 package.json 并自动安装依赖 & 运行预览（适用于文件夹和 Git 导入）（@wonderwhy-er）
• ✅ 可视化选择工具：直观地定位需要更改的地方（@emcconnell）
• ✅ 检测终端错误并请求 bolt 修复（@thecodacus）
• ✅ 检测预览错误并请求 bolt 修复（@wonderwhy-er）
• ✅ 添加 Starter Template 选项（@thecodacus）
• ✅ Perplexity 集成（@meetpateltech）
• ✅ AWS Bedrock 集成（@kunjabijukchhe）
• ⬜ 高优先级 - 避免 bolt 频繁重写文件（文件锁和 diffs）
• ⬜ 高优先级 - 为小型 LLM 提供更好的提示（有时代码窗口无法正常启动）
• ⬜ 高优先级 - 在后端运行代理，而不是仅单次模型调用
• ⬜ 直接部署到 Vercel/Netlify 等平台
• ⬜ 让 LLM 在 Markdown 文件里先规划整个项目，提升效果并提升透明度
• ⬜ VSCode 集成，具有类似 Git 的变更确认流程
• ⬜ 上传文档以扩充知识库（例如 UI 设计模板、某段代码库来参考编码风格等）
• ⬜ 语音提示输入
• ⬜ Azure Open AI API 集成
• ⬜ Vertex AI 集成
• ⬜ Granite 集成
• ⬜ 为 Web Container 提供弹出窗口

---

功能简介（Features）

• AI 驱动的全栈 Web 开发，可直接在浏览器中完成。
• 支持多种 LLM，并且具有可扩展的架构，便于集成更多模型。
• 在提示中添加图片，提供更好的上下文理解。
• 集成终端，可查看 LLM 执行命令的输出信息。
• 代码版本回退，便于调试和快速改动。
• 支持下载项目为 ZIP，方便移植和保存。
• 提供 Docker 一键集成，部署安装更加轻松。

---

环境搭建（Setup）

如果你是第一次从 GitHub 上安装软件，不用担心！在遇到问题时，你可以随时通过提交 “issue” 来向我们求助，或者通过 fork 仓库、修改文档、提交 Pull Request 来改进本教程。以下说明将帮助你在本地快速搭建稳定版本的 Bolt.DIY。

让我们开始吧！

---

快速下载

← 点击此处跳转到最新版本！

• 然后 点击 source.zip 下载源码

---

前置条件（Prerequisites）

在开始之前，你需要安装以下两个关键软件：

1. 安装 Node.js

Node.js 用于运行该应用。

1. 前往 Node.js 下载页面
2. 下载适用于你操作系统的 “LTS” 版本
3. 使用默认设置安装
4. 验证 Node.js 安装是否成功：
   • Windows 用户：
     1. 按下 Windows + R
     2. 输入 “sysdm.cpl”，回车
     3. 切换到 “高级” → “环境变量”
     4. 检查 Node.js 是否已经包含在 “Path” 变量中
   • Mac/Linux 用户：
     1. 打开终端（Terminal）
     2. 输入命令：

        bash
        1echo $PATH

     3. 查看输出中是否包含 /usr/local/bin

---

运行应用（Run the Application）

你可以通过两种方式来运行 Bolt.DIY：直接在本机运行或使用 Docker。

方式 1：直接安装并运行（推荐给初学者）

1. 安装包管理器 pnpm：

   bash
   1npm install -g pnpm

2. 安装项目依赖：

   bash
   1pnpm install

3. 启动应用：

   bash
   1pnpm run dev

   重要提示：如果你使用的是 Google Chrome 浏览器进行本地开发，你需要安装 Chrome Canary
   点击此处下载

方式 2：使用 Docker

如果你对 Docker 较为熟悉，可以选择这种方式，并在更隔离的环境中运行。

额外前置条件

• 安装 Docker：下载 Docker

步骤：

1. 构建 Docker 镜像：

   bash
   1# 使用 npm 脚本：
   2npm run dockerbuild
   3
   4# 或者直接使用 Docker 命令：
   5docker build . --target bolt-ai-development

2. 运行容器：

   bash
   1docker-compose --profile development up

---

配置 API Key 和提供方（Providers）

添加你的 API Key

在 Bolt.DIY 中添加 API Key 十分简单：

1. 打开主界面（首页）
2. 在提供方下拉菜单中选择你需要的提供方
3. 点击铅笔（编辑）图标
4. 在安全输入框中填写你的 API Key

配置自定义 Base URL

对于支持自定义 Base URL 的提供方（例如 Ollama 或 LM Studio），可按以下步骤操作：

1. 点击侧边栏的设置图标打开设置菜单
   
2. 进入 “Providers” 标签页
3. 使用搜索栏找到对应的提供方
4. 在指定字段中输入自定义 Base URL
   

注意：如果你在本地部署 AI 模型或使用自定义 API 接口，自定义 Base URL 非常实用。

已支持的提供方

• Ollama
• LM Studio
• OpenAILike

---

通过 Git 克隆（仅限开发者）

如果你想要：

• 为项目做出贡献
• 获取最新的更新
• 在不同版本之间切换
• 添加自定义功能

可以考虑使用 Git。

前置条件

1. 安装 Git：下载 Git

初始设置

1. 克隆仓库：

   bash
   1# 使用 HTTPS
   2git clone https://github.com/stackblitz-labs/bolt.diy.git

2. 进入项目目录：

   bash
   1cd bolt.diy

3. 切换到 main 分支：

   bash
   1git checkout main

4. 安装依赖：

   bash
   1pnpm install

5. 启动开发服务器：

   bash
   1pnpm run dev

保持更新

1. 保存本地修改（如果有）：

   bash
   1git stash

2. 拉取最新更新：

   bash
   1git pull origin main

3. 更新依赖：

   bash
   1pnpm install

4. 恢复本地修改（如果有）：

   bash
   1git stash pop

Git 设置常见问题

1. 重新安装：

   bash
   1# 删除 node_modules 和锁文件
   2rm -rf node_modules pnpm-lock.yaml
   3
   4# 清理 pnpm 缓存
   5pnpm store prune
   6
   7# 重新安装依赖
   8pnpm install

2. 重置本地改动：

   bash
   1# 放弃所有本地改动
   2git reset --hard origin/main

记得在拉取更新之前，先提交或 stash 你本地的改动，避免冲突。

---

可用脚本（Available Scripts）

• pnpm run dev：启动开发服务器
• pnpm run build：打包项目
• pnpm run start：使用 Wrangler Pages 在本地运行打包后的应用
• pnpm run preview：构建并在本地预览生产环境构建版本
• pnpm test：使用 Vitest 运行测试
• pnpm run typecheck：运行 TypeScript 类型检查
• pnpm run typegen：使用 Wrangler 生成 TypeScript 类型
• pnpm run deploy：将项目部署到 Cloudflare Pages
• pnpm run lint:fix：自动修复 Lint 问题

---

路线图（Roadmap）

查看我们的 路线图 以了解未来功能和开发重点。