如何搭建 Vane 本地开发环境并用 npm run dev 启动？

如何搭建 Vane 本地开发环境并用 npm run dev 启动？

【免费下载链接】VaneVane is an AI-powered answering engine.项目地址: https://gitcode.com/GitHub_Trending/pe/Vane

Vane 是一个运行在本地硬件上的 AI 回答引擎，基于 Next.js 构建，内置搜索、引用来源和 LLM 集成。如果你在修改 Vane 的代码（搜索流程、UI、模型 provider 等），需要先搭好本地开发环境：安装依赖、用npm run dev启动开发服务器，然后在浏览器里完成首次配置。本文基于仓库中 CONTRIBUTING.md 的“Setting Up Your Environment”章节和 README.md 的非 Docker 安装说明，给出一条从克隆仓库到进入设置界面的连续操作路径。

准备条件：先准备好 SearXNG 搜索后端

Vane 的联网搜索依赖 SearXNG。非 Docker 安装的第一步是：

Install SearXNG and allowJSONformat in the SearXNG settings. Make sure Wolfram Alpha search engine is also enabled. —— README.md

也就是说，在启动 Vane 之前，你需要有一个可用的 SearXNG 实例，并且确认两件事：

• formats中启用了json；
• wolframalpha引擎处于启用状态。

仓库里 searxng/settings.yml 就是 Docker 镜像内置的参考配置，其中search.formats同时包含html和json，engines里wolframalpha为disabled: false，可以直接对照检查自己的 SearXNG 是否满足要求。具体的 SearXNG 地址稍后在 Vane 的设置界面里填写，不需要在启动命令里指定。

克隆仓库并安装依赖

git clone https://github.com/ItzCrazyKns/Vane.git cd Vane

进入项目目录后，安装依赖。开发文档中给出的命令是：

npm install

package.json 中dev脚本就是next dev，所以依赖装好后不需要额外配置环境变量即可进入下一步。

用 npm run dev 启动开发服务器

npm run dev

CONTRIBUTING.md 明确区分了两种运行方式的定位：

Docker configurations are present for setting up production environments, whereasnpm run devis used for development purposes.

因此npm run dev只面向本地开发；生产环境应走 Docker 或非 Docker 的npm run build+npm run start路径（见 README.md 的 Non-Docker Installation 一节），不要把两条路径混在同一次操作里。

启动过程中无需手动处理数据库：CONTRIBUTING.md 说明 “Database migrations are applied automatically on startup”，迁移在应用启动时自动执行，开发者不用先跑任何迁移命令。

完成首次设置并验证

服务起来后，打开浏览器访问：

http://localhost:3000

按 CONTRIBUTING.md 的要求，在 UI 的设置界面里完成配置：

• API keys（如 OpenAI、Anthropic、Groq，或本地 Ollama 的 API 地址）；
• models（聊天模型与 embedding 模型）；
• search backend URL（前面准备好的 SearXNG 实例地址）。

判断环境是否搭好：页面能正常打开并进入上述设置界面，说明开发服务器和数据库迁移都工作正常；设置项填完后，发一条测试消息能返回带引用来源的回答，说明 LLM 与搜索后端都已连通。

开发过程中的约定与后续操作

• 提交代码前，CONTRIBUTING.md 要求先跑npm run format:write（即prettier . --write）并按项目标准检查代码。
• 涉及搜索行为的改动，核心代码在src/lib/agents/search；模型 provider 在src/lib/models/providers。这些定位信息同样来自 CONTRIBUTING.md 的“Where to make changes”一节，可以作为下一步阅读的入口。
• 如果之后要更新 Vane 版本，非 Docker 用户的路径是git pull origin master后重新npm i，见 docs/installation/UPDATING.md。

【免费下载链接】VaneVane is an AI-powered answering engine.项目地址: https://gitcode.com/GitHub_Trending/pe/Vane