项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4822
技术标签
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 需自建后端:README 要求用 Docker 部署自有后端以支持认证与搜索功能
- 需自备模型提供方:本地 Ollama / llama.cpp,或任意 OpenAI 兼容服务的 API Key
- 支持 web、iOS、Android、Mac、Linux、Windows 多平台客户端
- 项目仍在早期开发阶段,官方当前面向希望 on-prem 部署的企业客户
安装与启动步骤
-
1克隆项目仓库
把 Thunderbolt 仓库克隆到本地,后续后端部署与配置都基于该目录。
git clone https://github.com/thunderbird/thunderbolt cd thunderbolt -
2阅读部署文档
仓库中的 deploy/README.md 是自建后端的部署说明,README 未给出具体命令,务必先通读该文档。
-
3Docker 部署后端
按 deploy/README.md 的步骤用 Docker 部署你自己的后端服务;本项目 README 未直接给出可执行命令。
-
4注册后端账号
README 说明当前仍依赖认证功能,需自行注册账号后才能本地试用客户端。
-
5准备模型提供方
官方没有公共推理端点,需自行接入模型:可安装 Ollama 或 llama.cpp 做免费本地推理,或准备 OpenAI 兼容 API Key。
-
6配置模型与搜索
在客户端设置中填入模型提供方的 API Key;若不需联网搜索,可在集成页面关闭搜索功能。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
模型提供方 API Key | 是 | 在设置中添加任意 OpenAI 兼容模型提供方的密钥 | sk-xxxxxxxx |
搜索功能开关 | 否 | 可在应用的集成页面关闭搜索,减少对联网服务的依赖 | 关闭 |
如何确认成功
能成功注册并登录自建后端,进入客户端主界面后所选模型可以正常对话,即部署成功。
常见问题
Q:必须联网才能使用吗?
A:目前仍需认证与搜索功能支持,但可在应用的集成页面关闭搜索。官方计划最终实现完全离线优先。
Q:怎样免费使用本地推理?
A:README 推荐搭配 Ollama 或 llama.cpp,两者都可在本地免费运行模型,无需支付云端推理费用。
Q:官方提供公共推理端点吗?
A:没有。README 明确表示尚未提供公共推理端点,需要你自己添加模型提供方或填入 API Key。
Q:可以在哪些平台上运行?
A:Thunderbolt 是跨平台客户端,覆盖 web、iOS、Android、Mac、Linux 和 Windows。
注意事项
- 项目处于早期活跃开发阶段,不建议直接用于生产环境的严格场景。
- README 未提供具体安装命令,后端部署细节以仓库 deploy/README.md 与官网 thunderbolt.io 为准。
- 接入模型提供方和 API Key 由用户自行负责,注意密钥保管与数据隐私。
核心亮点
- 模型无关设计,轻松切换 OpenAI、Ollama 等,无需改代码
- 强调数据主权,支持本地优先存储,隐私更安全
- TypeScript 全栈,类型安全,对前端开发者友好
不足之处
- 文档/社区待观察
- 生态尚小,集成组件不如主流框架丰富
适用场景
- 构建隐私敏感的企业内部 AI 助手
- 开发需要灵活切换模型供应商的 AI 应用
- 在边缘设备上运行轻量级 AI 推理
替代项目
LangChain、LlamaIndex、Vercel AI SDK
上一篇:agent-skills
下一篇:agnt
同类项目推荐
awesome-claws
开源
按场景逛 OpenClaw 生态,快速找到你要的工具和社区
A curated list of OpenClaw-related products, skills, communities, and ecosystem reso···
book-genesis-v4
开源
把书稿创意变成完整手稿,盲评把关质量
Open-source writing skills for Claude Code, Codex, OpenCode, Antigravity, Gemini, Op···
Alfred
开源
用自然语言问数据,让业务人员也能自助分析
Alfred: An open-source Data Assistant for domain adoption, powered by agent skills, ···
KohakuTerrarium
开源
内置工具与多智能体,开箱即用跑起 AI 团队
KohakuTerrarium is a general-purpose AI agent framework and batteries-included app f···
turbo-flow
开源
一键部署多智能体集群,云端开发自动化提速
The rules layer for AI-written code — rig-lite: a fail-closed cross-model review ga···
CookHero
开源
动动嘴问菜谱,AI 帮你做菜又管营养
CookHero是一个基于 LLM + RAG + Agent + 多模态的智能饮食与烹饪管理平台,支持智能菜谱查···
iPolloWork
开源
本地优先的 AI 工作空间,让代码、文档、设计结果可编辑可控。
Enterprise-grade, local-first Agent Workbench for people and agent teams. A unified ···
langgraph
开源
把AI代理从“黑盒”变成“流程图”,可控又可靠。
Build resilient agents.
sivalabs-agent-skills
开源
让 AI 编码助手更懂 Spring Boot,生成规范代码
Spring Boot skills for AI coding agents
