Thunderbolt本地开发环境搭建教程：从克隆仓库到第一次AI对话

Thunderbolt本地开发环境搭建教程从克隆仓库到第一次AI对话【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderbolt想在本地跑起来 Thunderbolt 这个开源 AI 客户端吗本教程带你完成Thunderbolt 本地开发环境的完整搭建从克隆仓库、安装依赖到启动后端与前端再到发送第一条 AI 消息。全程只需 4 条make命令新手也能在 10 分钟内看到效果 ⚡Thunderbolt 是一个可自托管、跨平台Web / iOS / Android / macOS / Linux / Windows的开源 AI 聊天客户端核心理念是AI You Control模型自选、数据自有、告别厂商锁定。一、开始前的工具清单Thunderbolt 采用 Bun Vite 前端、Bun 后端 Docker 容器的技术栈。克隆仓库后先运行环境检查命令它会扫描你的机器并直接打印缺失工具的安装命令make doctor根据 docs/development/quick-start.md 的说明本地开发至少需要工具用途备注Bun 1.2前端 后端运行时必装Docker运行 Postgres 和 PowerSync 容器必装Rust 工具链Tauri 桌面/移动端构建仅桌面 App 开发需要sccache加速 Rust 重建可选cargo install sccache Linux 用户注意Tauri 桌面端还需要 GTK/WebKit 开发库make doctor在 Linux 上会一并检查这些依赖。二、克隆仓库并一键安装依赖git clone https://gitcode.com/GitHub_Trending/thund/thunderbolt cd thunderbolt make setupmake setup会自动完成三件事详见根目录 Makefile 中的setup目标安装前端依赖bun install安装后端依赖cd backend bun install安装 Playwright 浏览器供端到端测试使用三、创建 .env 配置并填入 AI 模型密钥Thunderbolt 不内置推理服务你需要至少配置一个 AI 模型提供方cp .env.example .env cp backend/.env.example backend/.env make doctor两个环境文件分工明确根目录.envVite/Tauri 前端配置backend/.envAPI 服务配置make doctor会自动为backend/.env生成BETTER_AUTH_SECRET会话签名密钥。接下来在backend/.env中填入至少一个AI 模型密钥例如ANTHROPIC_API_KEY你的密钥支持 Anthropic、Fireworks、Mistral 等提供方如果想免费本地推理也可以用 Ollama 或 llama.cpp把THUNDERBOLT_INFERENCE_URL指向本地服务即可。完整变量说明见docs/self-hosting/configuration.md。四、启动数据库与同步服务make up这一条命令通过 powersync-service/docker-compose.yml 在 Docker 中启动两个服务PostgreSQL监听:5433特意避开默认端口防止和你本机的 Postgres 冲突PowerSync实时数据同步服务监听:8080用make status可以随时确认容器状态make down停止容器、make nuke则彻底清空数据重建。五、启动开发服务器make runmake run会先清理:8000和:1420上的残留进程然后同时拉起服务地址后端 APIhttp://localhost:8000前端界面http://localhost:1420️ 桌面 App 开发可用bun tauri:dev:desktopiOS 模拟器用bun tauri:dev:iosAndroid 模拟器用bun tauri:dev:android。六、发送你的第一次 AI 对话打开 http://localhost:1420创建账号并登录然后在输入框里提问 —— 如果 AI 正常回复说明本地开发环境已经完全就绪 登录后你还可以顺手逛一逛这些页面感受 Thunderbolt 的核心能力Agents内置 Agent 与终端 CLI Agent支持接入任意 ACP 协议远程 AgentSkills技能开关列表搜索、研究、天气、地图等Models管理你自己的模型密钥与模型配置七、常见问题速查症状解决办法make up端口冲突有服务占用了5433或8080停掉它们或修改 compose 文件Postgres 数据格式报错镜像升级到 v18 后磁盘布局变化执行make nuke清空重建BETTER_AUTH_SECRET报错重新运行make doctor自动生成或手动执行openssl rand -base64 32powersyncJwtSecret must be at least 32 characters在backend/.env中把POWERSYNC_JWT_SECRET设为与powersync-service/config/config.yaml一致的值更多细节可查阅docs/development/quick-start.md的 Common Issues 章节。八、下一步常用命令与扩展方向命令作用make doctor-q安静模式只输出问题项make check类型检查 Lint 格式检查make format一键格式化前端、后端与 Rust 代码make build-desktop构建 Tauri 桌面发布包环境跑通之后推荐按这条路线深入配置参考docs/self-hosting/configuration.md全部后端环境变量系统架构docs/architecture/README.md各组件如何协作测试指南docs/development/testing.md单元测试与 Playwright E2E 规范正式自托管部署deploy/README.mdDocker Compose 与 Kubernetes 方案至此你的 Thunderbolt 本地开发环境已经可以支撑日常开发了改前端、调后端、换模型全部在本地闭环完成。祝你开发愉快 ⚡【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderbolt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考