项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 27642
使用教程
环境要求
- 已安装并运行 Docker(含 Docker Compose V2)
- 至少一块能跑 Magistral / Qwen / Deepseek 14B 的 GPU
- 本地 LLM provider(ollama / lm-studio / openai 兼容服务)
- 首次拉取镜像需较长时间,建议预留 30 分钟以上
安装与启动步骤
-
1克隆仓库并初始化
下载项目代码,进入目录并把 .env.example 复制为 .env 作为配置文件
git clone https://github.com/Fosowl/agenticSeek.git cd agenticSeek mv .env.example .env -
2启动 Docker
Linux/macOS 用 systemctl 启动,Windows 从开始菜单打开 Docker Desktop;docker info 有输出即正常
sudo systemctl start docker docker info -
3启动本地模型服务
先导出监听地址,再启动 ollama 服务;不用本地模型可跳过,改用 API 模式
export OLLAMA_HOST=0.0.0.0:11434 ollama serve -
4修改 config.ini
把 provider_name 改为所用服务,provider_model 改为本地已下载的模型;该文件不支持注释,勿直接粘贴示例
-
5启动全部服务
会依次启动 searxng、redis、frontend、backend;Windows 改用 start start_services.cmd full
./start_services.sh full -
6打开 Web 界面
等待日志出现 backend: "GET /health HTTP/1.1" 200 OK 后再发送消息,首次启动可能需 5 分钟
-
7CLI 模式安装(可选)
想在宿主机用命令行界面时执行安装脚本,Windows 使用 ./install.bat,并需改 .env 中的 SEARXNG_BASE_URL
./install.sh -
8改用 API 模式(可选)
显存不足时把 key 设为环境变量,并在 config.ini 中设置 is_local = False 与对应 provider_name
export TOGETHER_API_KEY="xxxxxxxxxxxxxxxxxxxxxx"
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
is_local | 是 | 是否使用本地模型,用 API 时设为 False | True |
provider_name | 是 | 模型服务商,如 ollama、lm-studio、openai | ollama |
provider_model | 是 | 要调用的模型名,需与服务商匹配 | deepseek-r1:14b |
provider_server_address | 否 | 模型服务地址,API 模式下通常留空 | 127.0.0.1:11434 |
SEARXNG_BASE_URL | 否 | CLI 模式下写入 .env,指向宿主机映射地址 | http://localhost:8080 |
PROVIDER_API_KEY | 否 | API 模式下的服务商密钥环境变量名 | xxxxxxxxxxxxxxxxxxxxxx |
如何确认成功
浏览器打开 http://localhost:3000/ 能看到 Web 界面,且日志出现 backend: "GET /health HTTP/1.1" 200 OK
常见问题
Q:config.ini 可以照抄 README 的示例吗?
A:不可以。config.ini 不支持注释,示例里的 # 注释会导致错误,需手动逐项填写并去掉注释。
Q:用 LM Studio 时 provider_name 怎么写?
A:必须写 lm-studio,不能写 openai;且部分 provider 要求地址带 http:// 前缀,如 http://127.0.0.1:1234。
Q:硬件跑不动本地大模型怎么办?
A:改用 API 模式:设置 is_local = False,配置 provider_name/provider_model,并把 API Key 写入环境变量。
Q:启动脚本报错怎么办?
A:先确认 Docker Engine 正在运行、Docker Compose V2 已正确安装,再根据终端报错信息排查。
Q:服务启动很久是正常的吗?
A:正常。首次启动会下载并加载全部镜像,可能长达 30 分钟,后端首次启动也可能耗时 5 分钟。
注意事项
- CLI 模式要改的是 .env 里的 SEARXNG_BASE_URL,不是 config.ini;若改过 SEARXNG_PORT 需用对应端口。
- start_services.sh 用于 MacOS,Windows 使用 start start_services.cmd full。
- config.ini 不支持注释,请勿整段复制 README 示例。
- 必须等 backend 完全就绪后再发送消息,否则请求会失败。
核心亮点
- 完全本地推理,隐私零泄露,离线也能用
- 零 API 费用,省下每月 200 美元订阅
- 集成 DeepSeek-R1,思考、上网、写代码全自动
不足之处
- 本地运行需较高硬件配置,普通电脑可能卡顿
- 文档/社区待观察
适用场景
- 隐私敏感场景下的自主信息搜集与报告生成
- 离线开发环境中的代码辅助与自动化脚本编写
- 低成本搭建个人 AI 助理,处理日常网页浏览任务
替代项目
Manus AI、OpenManus、AutoGPT
上一篇:agent-fleet-o
同类项目推荐
Evolving-Visual-Generation
开源
一张图看懂视觉生成技术进化史,从扩散模型到智能体世界建模
[Roadmap] Visual Generation in the New Era: An Evolution from Atomic Mapping to Agen···
MCP-SuperAssistant
开源
给所有主流AI聊天框装上MCP工具,秒变超级助手
Brings MCP to ChatGPT, DeepSeek, Perplexity, Grok, Gemini, Google AI Studio, OpenRou···
ableton-mcp
开源
用自然语言指挥 Ableton Live,AI 帮你编曲混音
Control Ableton Live with any LLM: create tracks, arrange clips & compose music via ···
skybridge
开源
用 TypeScript 一套代码构建 MCP 和 ChatGPT 应用,类型安全,React 驱动
Skybridge is a full-stack TypeScript framework for MCP Apps and ChatGPT Apps. Type-s···
DashClaw
开源
危险操作先拦下确认再放行,用 AI 干活睡得着
Remote approvals, policy checks, and execution evidence for unattended AI agents.
samples
开源
照着抄,快速搭建你的 AI 智能体应用
Agent samples built using the Strands Agents SDK.
agent-os
开源
给AI智能体装上安全治理操作系统,防止失控
[DEPRECATED] Moved to microsoft/agent-governance-toolkit
awesome-ai-agents
开源
收藏AI智能体好项目,找资源不迷路
A curated list of awesome top best AI Agents
agent-pack-n-go
开源
25分钟克隆你的AI代理到新设备,配置记忆技能全带走
Clone your OpenClaw AI Agent to a new device in ~25 minutes — configs, memory, skil···
