ItzCrazyKns/Vane

项目介绍

Vane 是一个运行在自有硬件上的隐私优先 AI 问答引擎。用户提问后，它先通过 SearxNG 元搜索获取网页结果，再调用本地或云端大模型整合成带引用来源的答案。模型可选 Ollama、Lemonade 等本地服务，也可接 OpenAI、Claude、Gemini、Groq 等云端提供商，并能在不同查询间切换。

除文本问答外，它提供 Speed、Balanced、Quality 三档搜索模式权衡速度与深度；来源可选网页、讨论或学术论文；可限定只在指定域名内搜索；内嵌组件会按需展示天气、计算、股票价格等卡片；支持上传 PDF、文本和图片并就其提问；搜索记录保存在本地。

适合希望获得 Perplexity 式问答体验、又不想把查询交给第三方的人，也适合需要搜索 API 的开发者。

快速使用

推荐用 Docker 部署。默认镜像已内置 SearxNG，一条命令即可启动：

docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latest

打开 http://localhost:3000，在安装引导页填入 AI 提供商 API Key、模型及其他设置。数据卷用于持久化数据和上传文件。更新及其他说明见安装文档。

如果已有 SearxNG，可改用精简镜像并指向现有实例：

docker run -d -p 3000:3000 -e SEARXNG_API_URL=http://your-searxng-url:8080 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:slim-latest

此时 SearxNG 必须在设置中启用 JSON 输出，并开启 Wolfram Alpha 搜索引擎。

不用 Docker 时，克隆仓库后依次执行 npm i、npm run build、npm run start，再在 http://localhost:3000 配置 SearxNG 和模型；README 因依赖管理更简单而推荐 Docker。若想在浏览器地址栏直接搜索，可新增站点搜索并指向 http://localhost:3000/?q=%s。

使用约束

• 必须要有 SearxNG：使用内置镜像，或自备已开启 JSON 格式和 Wolfram Alpha 的实例。
• 必须配置模型提供商：本地 Ollama/Lemonade 需在 Docker 内可访问。Windows 和 Mac 填 http://host.docker.internal:11434；Linux 填宿主机私网 IP，并在 systemd 配置中设置 OLLAMA_HOST=0.0.0.0:11434。
• 兼容 OpenAI 接口的本地服务需监听 0.0.0.0，模型名要与实际加载的一致；即使服务端未定义 Key，API Key 字段也不能留空。
• 尚无内置认证：认证仍在待办清单中，公网暴露实例前应自行加访问控制。
• 许可证：MIT。

HotRepo 点评

2026-11-01，Vane 出现在 GitHub 全部语言日榜快照中的 TypeScript 语言榜上，当天该榜最好名次为第 16，新增 57 Star。站内未记录全部语言日榜名次，仅凭这一条快照也无法判断趋势。可以明确的是，该项目已积累相当关注度（该快照记录 37,935 Star、4,223 Fork），而它本质仍是需要自行接通 SearxNG 和模型提供商的自托管工具。它的实际价值在于带引用的答案与提供商可替换，而非某项基准成绩；README 中也没有可供核实的准确率或性能声明。