turboseek

环境要求

• 已安装 Node.js 与 npm（用于 npm install / npm run dev）
• Together AI 账号及其 API Key（用于大模型推理）
• SERP API（serper.dev）或 Azure Bing Search API 的账号与 Key（用于网页检索）
• Helicone 账号与 Key（用于可观测性）
• 可访问 GitHub 与 npm 源以克隆代码并安装依赖

安装与启动步骤

1. 1克隆项目代码

   把 TurboSeek 仓库克隆到本地，也可以先 Fork 再克隆自己的副本。

   git clone https://github.com/Nutlope/turboseek.git
   cd turboseek

   复制

2. 2注册外部服务账号

   分别在 Together AI、SERP API（或 Azure Bing Search API）、Helicone 注册账号并获取 API Key。

3. 3生成环境变量文件

   以仓库自带的 .example.env 为模板复制出 .env，文件内的变量名以模板为准。

   cp .example.env .env

   复制

4. 4填入各项密钥

   打开 .env，把模板中的占位值替换成上一步拿到的真实 Key，保存后不要提交到仓库。

5. 5安装依赖

   在项目根目录安装前端与后端依赖，网络较慢时可先配置国内 npm 源。

   npm install

   复制

6. 6启动开发服务器

   运行开发模式启动 Next.js 应用，终端会输出本地访问地址。

   npm run dev

   复制

关键配置

如何确认成功

终端出现启动成功提示且无报错，浏览器打开输出的本地地址（Next.js 默认 3000 端口）能看到搜索界面。

常见问题

注意事项

• 使用的模型为 gpt-oss 与 Llama 3.1 8B，检索结果来自搜索 API 返回的网页内容。
• .env 内含真实密钥，切勿提交到 Git 仓库或公开分享。
• README 未给出具体环境变量名与端口，以 .example.env 和终端输出的地址为准。
• 若要长期对外提供服务，需另行准备部署环境，README 只覆盖本地运行方式。