Fosowl/agenticSeek

AgenticSeek – 一款完全本地、支持语音的 AI 助手

它是什么

• 一个开源、隐私优先的 AI 代理，可以在你自己的硬件上浏览网页、运行代码并编排多步骤任务。它被定位为 Manus AI 等商业服务的本地替代方案。

主要功能

• 自主网页浏览 – 无需用户干预即可搜索、阅读页面、提取信息并填写网页表单。
• 编程助手 – 直接在您的机器上生成、调试和执行多种语言（Python、C、Go、Java 等）的代码。
• 动态代理选择 – 系统决定哪个专门的“代理”（例如，网络搜索器、编码器、规划器）最适合给定的请求。
• 任务规划与执行 – 将复杂目标（旅行规划、项目脚手架）分解为步骤，并使用多个代理执行。
• 语音交互 – 实验性的语音转文字和文字转语音功能，让您可以与助手对话。
• 仅本地模式 – 使用本地托管的 LLM（Ollama、LM-Studio 等）运行，并将所有文件、对话和搜索结果存储在您的设备上。云 API 是可选的。

工作原理

1. 后端 – 一个 Python 服务，与语言模型（本地或远程）通信并协调代理。
2. 前端 – 一个 React Web UI（在 http://localhost:3000 上提供），通过 API 令牌与后端通信。
3. 支持服务 – Docker-compose 启动：
   • SearXNG – 用于 Web 查询的开源元搜索引擎。
   • Redis – SearXNG 所需的轻量级存储。
   • 前端和后端容器（可选；您也可以直接在主机上以 CLI 模式运行后端）。
4. LLM 提供商 – 您可以接入任何兼容的模型：
   • 本地：Ollama、LM-Studio 或任何兼容 OpenAI 的服务器（例如 llama.cpp）。
   • 远程 API：OpenAI、Google Gemini、Deepseek、TogetherAI、HuggingFace、OpenRouter、MiniMax 等。
5. 配置 – .env 中的环境变量定义服务 URL/端口，而 config.ini 选择 LLM 提供商、模型和行为标志（语音、个性、语言列表等）。

安装与快速开始

# 1. 克隆并准备
git clone https://github.com/Fosowl/agenticSeek.git && cd agenticSeek
mv .env.example .env

# 2. 编辑 .env – 设置端口、WORK_DIR 以及您需要的任何 API 密钥
#    （如果您运行本地模型，请将 LLM 密钥留空）

# 3. 启动 Docker 服务（完整版包括后端）
./start_services.sh full   # macOS/Linux
# 或在 Windows 上
start start_services.cmd full

# 4. 打开 UI
open http://localhost:3000   # 或在浏览器中手动访问

• 首次加载 UI 时会要求输入 API 令牌；从后端日志中获取（docker compose logs backend | grep "API token"）。
• 仅使用 CLI 时，运行 ./install.sh（或 install.bat），将 SEARXNG_BASE_URL 调整为 http://localhost:<port>，然后启动服务并运行 uv run cli.py。

运行本地 LLM

• 安装 Ollama（或 LM-Studio），启动服务器（ollama serve），并通过 OLLAMA_HOST=0.0.0.0:11434 将其暴露。
• 编辑 config.ini：

  [MAIN]
  is_local = True
  provider_name = ollama
  provider_model = deepseek-r1:14b   # 或您的硬件可以处理的任何模型
  provider_server_address = 127.0.0.1:11434
  

• 最低硬件要求：能够运行约 14B 参数模型（例如，Magistral、Qwen、Deepseek 14B）的 GPU。

使用云 API

• 填写相应的 *_API_KEY 环境变量，在 config.ini 中设置 is_local = False，选择 provider_name（例如 openai）和模型名称（例如 gpt-3.5-turbo）。

典型工作流程

1. 输入或说出请求，例如：
   • “搜索法国雷恩最好的咖啡馆，并将三个带地址的保存到 rennes_cafes.txt。”
2. AgenticSeek 选择 网络搜索 代理，通过 SearXNG 执行查询，解析结果，并将文件写入您的 WORK_DIR。
3. 对于编码任务，编码器代理生成源文件，运行它们（如果安全），并返回输出。
4. 复杂目标触发 规划器 代理，该代理创建逐步计划并将子任务委派给适当的代理。

文件处理

• 上传的文件出现在 WORK_DIR/.user_uploads/ 下，并自动进行名称消歧。
• 系统遵守每个文件 50 MB 的限制。

限制与状态

• 早期原型 – 代理路由可能错误分配任务；明确的提示会有所帮助。
• 浏览器中的表单填写是实验性的。
• 语音功能（listen、speak）仍在开发中，仅在 CLI 模式下工作。
• 没有正式的路线图或资金；欢迎社区贡献。

许可证

• GPL-3.0（请参阅 README 中的徽章）。

获取帮助的地方

• Discord：https://discord.gg/8hGDaME3TC
• GitHub Issues 和 Pull Requests
• 多语言 README（中文、法语、日语等），以覆盖更广泛的社区。

---

底线：AgenticSeek 是一个自托管的 AI 助手，将网络搜索、代码生成和任务规划整合到一个保护隐私的软件包中。它适合拥有强大 GPU 并希望将所有 AI 交互保留在设备上的用户，同时在需要时也提供回退到云 API 的选项。