项目简介
Thunderbolt 是一款开源跨平台 AI 客户端，用户可自由选择模型、拥有数据、消除厂商锁定。支持桌面与移动端，并可本地部署。
README 预览
# Thunderbolt [](https://github.com/thunderbird/thunderbolt/actions/workflows/ci.yml)\n\n**AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.**\n\n\n\n> [!IMPORTANT]\n> ⚠️ **We are excited about the amount of interest Thunderbolt has been getting and want to clarify that it is still early and under active development**. Currently, we are targeting enterprise customers that want to deploy it on-prem. We encourage you to self-host it and try it out, but there are a few caveats we are still working on:\n>\n> - While we eventually plan to make Thunderbolt fully offline-first, it currently depends on authentication and search functionality (though you can disable search on the integrations screen in the app). You can [deploy your own backend with Docker](./deploy/README.md) and sign up in order to test it locally.\n> - You’ll need to add your own model providers - we don’t yet have a public inference endpoint. We recommend using Thunderbolt with [Ollama](https://ollama.com) or [llama.cpp](https://github.com/ggml-org/llama.cpp) if you want free local inference, or you can add API keys for any OpenAI-compatible model provider in the settings.\n\nThunderbolt is an open-source, cross-platform AI client that can be deployed on-prem anywhere.\n\n- 🌐 Available on all major desktop and mobile platforms: web, iOS, Android, Mac, Linux, and Windows.\n- 🧠 Compatible with frontier, local, and on-prem models.\n- 🙋 Enterprise features, support, and FDEs available.\n\n**Thunderbolt is under active development, currently undergoing a security audit, and preparing for enterprise production readiness.**\n\n## Get Started Locally\n\n```sh\nmake doctor # verify your tools — prints exact install commands for anything missing\nmake setup # install frontend + backend dependencies, wire up agent symlinks\nmake up # start Postgres + PowerSync in Docker\nmake run # start the backend (:8000) and frontend (:1420)\n```\n\nFor self-hosting with Docker C
常见问题 (5)
informationalThunderbolt在自托管实例上默认是否收集遥测数据？
informational
Thunderbolt在自托管实例上默认是否收集遥测数据？不，对于自托管/OIDC部署，遥测默认是禁用的。消费者/云部署仍然默认启用遥测。此更改在PR #714中实现。
故障排除在Ubuntu上构建Tauri应用时，如何修复'javascriptcoregtk-4.1 not found'错误？
故障排除
在Ubuntu上构建Tauri应用时，如何修复'javascriptcoregtk-4.1 not found'错误？安装Tauri的Linux系统依赖：
sudo apt install libwebkit2gtk-4.1-dev libjavascriptcoregtk-4.1-dev \
build-essential curl wget file libxdo-dev libssl-dev \
libayatana-appindicator3-dev librsvg2-dev libsoup-3.0-dev其他发行版，请参阅 [Tauri的先决条件](https://v2.tauri.app/start/prerequisites/#linux)。同时确保已安装
sccache（cargo install sccache）。故障排除为什么我在自托管的Docker部署中，在OIDC登录后，尽管回调成功，仍然收到401错误？
故障排除
为什么我在自托管的Docker部署中，在OIDC登录后，尽管回调成功，仍然收到401错误？这是OIDC认证模式的一个已知问题，导致在回调后无法持久化Bearer令牌。已在PR #782中通过切换到会话cookie认证修复。请升级您的部署并将环境变量VITE_AUTH_MODE从'oidc'更改为'sso'。同时更新您的身份提供商（例如Keycloak）以反映新的回调URL。所有经过身份验证的请求将在登录后立即生效。
故障排除如何修复Postgres容器的'这些Docker镜像被配置为以与pg_ctlcluster兼容的格式存储数据库数据'错误？
故障排除
如何修复Postgres容器的'这些Docker镜像被配置为以与pg_ctlcluster兼容的格式存储数据库数据'错误？更新你的docker-compose.yml：将卷挂载从/var/lib/postgresql/data更改为/var/lib/postgresql。例如，将'- postgres_data:/var/lib/postgresql/data'替换为'- postgres_data:/var/lib/postgresql'。或者，将Postgres镜像固定为postgres:17-alpine以保留旧的数据布局。
故障排除为什么在部署Thunderbolt v0.1.91后，Kubernetes中的后端pod启动失败？
故障排除
为什么在部署Thunderbolt v0.1.91后，Kubernetes中的后端pod启动失败？v0.1.91 版本的后端部署缺少 BETTER_AUTH_SECRET 环境变量，导致 Pod 在启动时崩溃。该问题已在 PR #548 中修复，并将在未来版本中包含。作为临时解决方案，请手动将 BETTER_AUTH_SECRET 变量添加到您的后端部署 YAML 文件中。