如何上手 AgenticSeek：本地完成网页浏览、写代码与任务规划
项目地址: https://gitcode.com/GitHub_Trending/ag/agenticSeek AgenticSeek 是一个 100% 本地运行的自主 AI 助手：它能浏览网页、编写并运行代码、把多步骤任务拆开执行，全部跑在你自己的机器上，不用付云 API 费用。下面给出安装步骤，并带你用它完成一个真实的检索任务。
先给结果
拿"查资料 + 写东西"这类任务对比，差异如下：
| 场景 | 以前 | 用 AgenticSeek 后 |
|---|---|---|
| 检索并整理信息 | 自己开浏览器翻页，手工抄进文档 | 一句话，它搜网页、读页面，把 txt 清单写进本地目录 |
| 写个小脚本 | 自己开编辑器、写代码、调试 | 一句话，它写代码、运行、把文件存进工作目录 |
| 多步骤任务 | "搜索→筛选→记录→写脚本"全靠手动 | 路由器先拆出步骤计划，再由多个代理逐步执行 |
| 数据去向 | 提示词和结果过第三方接口 | 用 Ollama/LM-Studio 时，推理、搜索、文件操作都在本地 |
上表"后"一栏的每条任务，都能在官方 README 的使用示例里找到对应原句，例如"搜索网页并保存为文件"、"写程序并存到工作目录"。
跑起来 🔧
前置条件：Git、Python 3.10.x、Docker（含 Compose V2）。本地跑模型建议 12GB 以上显存的 GPU；官方 FAQ 明确 7B 小模型"幻觉多、不推荐"。硬件不够也可以改用云端 API，但那就不是纯本地了。
- 克隆并初始化配置：
git clone https://gitcode.com/GitHub_Trending/ag/agenticSeek
cd agenticSeek
mv .env.example .env
- 改两个配置文件：
.env里设SEARXNG_BASE_URL和WORK_DIR（它读写文件的目录）；config.ini里设provider_name = ollama和provider_model（选匹配你硬件的模型，如deepseek-r1:14b）。 - 启动服务：
./start_services.sh full # macOS / Linux
start start_services.cmd full # Windows
首次拉取 Docker 镜像最长约 30 分钟；等后端日志出现健康检查 200（首启约 5 分钟）后，打开 localhost:3000 就是 Web 界面。想后端跑在宿主机上就用 CLI 模式：先 ./install.sh，再 uv run cli.py，并把 .env 的 SEARXNG_BASE_URL 改成 http://localhost:8080。
完整做一个真实任务
选一条官方示例："Search the web for top cafes in Rennes, France, and save a list of three with their addresses in rennes_cafes.txt"（在法国雷恩搜最好的咖啡馆，把三家连地址存进 rennes_cafes.txt）。
- 输入：打开
localhost:3000，把这句话原样输入。README 特别建议把"做一次网络搜索"这类动作写明确，而不是含糊提问，否则路由可能分错代理。 - 路由：LLM 路由器判定这是网页任务，交给 Web 代理。
- 检索与阅读：Web 代理查询自托管的 SearXNG，再打开链接、在无头浏览器里读页面文本，循环直到信息足够。
- 输出：把三家咖啡馆的名字和地址写入
rennes_cafes.txt，位置在WORK_DIR指定的目录。 - 验证：打开该文件核对内容；也可以接着追问，比如"再查其中一家的营业时间"。
它怎么工作
AgenticSeek 内置 planner、coder、web、file、casual、mcp 几类代理。任务进来先过路由器判断复杂度：复杂的先交给 planner 生成步骤计划，简单的直接分给对应代理执行。代码任务由 coder 处理，支持 Python、C、Go、Java 等语言写代码并运行，代理源码在 sources/agents/。
工具层也全部自托管：搜索是 Docker 里的 SearXNG，浏览器是无头 Chrome（可开 stealth_mode 降低被检测概率），文件只能在 WORK_DIR 内读写。
config.ini 控制主要行为：is_local 区分本地模型和云端 API，recover_last_session 控制是否恢复上次会话，speak/listen 控制语音输出与输入（目前实验性，仅英文）。注意该配置文件不支持注释，手抄示例时要删干净。
边界与坑，以及适合谁
不适合的场景：
- 想要"装完就稳定能用"的生产环境：作者自述这是早期原型、没有固定路线图，路由"不总选对代理"
- 网页表单填写、注册类任务：README 标注该能力仍属实验性，可能失败
- 中文语音输入：语音转文字只支持英文，且仅限 CLI 模式
常见坑与解法：
- config.ini 报格式错误：文件不支持注释，README 示例里的注释必须删掉再写值
- Docker 后端连不上 Ollama：Ollama 默认只监听 127.0.0.1，在宿主机用
OLLAMA_HOST=0.0.0.0:11434 ollama serve绑定所有网卡 - 报 session not created：Chrome 与 ChromeDriver 版本不匹配，去 Chrome for Testing 下载对应版本，放到项目根目录
适合谁：
- 有 12GB+ 显存的本地 GPU（或一台能跑 Ollama 的远程机器），不想把任务内容和文件发给第三方
- 日常有"搜索 + 整理文件 + 写小脚本"的活，想把整段流程交给一句话
- 想加新代理或自定义工具的开发者，从贡献指南入手即可
项目是个人副业、没有资金和路线图，稳定性要求高的场景先别依赖它。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
