AgenticSeek 本地部署教程（Windows 系统）

#工作记录

Fosowl/agenticSeek：完全本地的 Manus AI。

部署排错参考资料在文末 或查找往期笔记。

AgenticSeek 本地部署教程（Windows 系统）

一、环境准备

1. 安装必备工具

• Docker Desktop
  下载地址：Docker Desktop 官网
  安装后启动 Docker 服务，确保后台运行。

• Python 3.10+
  下载地址：Python 官网
  安装时勾选 “Add Python to PATH”，建议安装后创建虚拟环境管理依赖。

• Ollama（语言模型服务）
  下载地址：Ollama 官网
  安装后启动 Ollama 服务，默认监听端口 11434。

2. 克隆项目并初始化

# 克隆项目
git clone https://github.com/your-username/agenticSeek.git
cd agenticSeek
mv .env.example .env

# 创建并激活虚拟环境（Windows）
python -m venv .venv
.venv\Scripts\activate



# CMD安装 如果是powershell则.\install.bat
install.bat

二、Docker 容器配置与启动

1. 修改 Docker 配置文件

路径：docker-compose.yml

操作说明：

• 重命名容器：避免与其他项目容器名称冲突

  services:
    redis:
      container_name: agenticseek_redis  # 重命名 Redis 容器
    searxng:
      container_name: agenticseek_searxng  # 重命名搜索引擎容器
    frontend:
      container_name: agenticseek_frontend  # 重命名前端容器
  

• 修改端口映射：解决端口占用问题（以 8080 为例）

  services:
    searxng:
      ports:
        - "8081:8080"  # 主机端口 8081 映射到容器端口 8080
    frontend:
      ports:
        - "3000:3000"  # 前端端口（默认即可，如需修改请同步前端代码）
  

2. 启动 Docker 容器

# 执行启动脚本（项目根目录）
start_services.cmd

# 验证容器状态
docker ps
# 预期输出：agenticseek_redis、agenticseek_searxng、agenticseek_frontend 状态为 "Up"

三、后端服务配置与启动

1. 解决配置文件编码问题

路径：api.py

操作：

修改读取配置文件的代码，强制使用 UTF-8 编码：

# 原代码
# config.read('config.ini')

# 修改后
config.read('config.ini', encoding='utf-8')

备选方案：

使用文本编辑器（如 VS Code）打开 config.ini，另存为 UTF-8 编码（无 BOM）。

2. 创建工作目录

操作：

在项目根目录创建后端工作目录（解决启动警告）：

mkdir workspace_for_agenticseek

3. 修改后端服务端口（可选）

路径：api.py

操作：

若默认端口 8000 被占用，修改为其他端口（如 8001）：

# 原代码
# uvicorn.run(app, host="0.0.0.0", port=8000)

# 修改后
uvicorn.run(app, host="0.0.0.0", port=8001)

4. 启动后端服务

# 确保虚拟环境已激活
.venv\Scripts\activate

# 启动后端
python api.py

# 预期输出：显示服务监听地址（如 http://0.0.0.0:8001）

 

四、配置前端与后端连接

1. 修改前端 API 地址

路径：frontend/agentic-seek-front/src/config.js（或环境变量文件）

操作：

确保前端代码中的后端地址与实际端口一致：

// 原配置（若端口为 8000）
// export const API_BASE_URL = 'http://localhost:8000';

// 修改后（端口为 8001）
export const API_BASE_URL = 'http://localhost:8001';

2. 重启前端服务

# 在 Docker 启动脚本中已包含前端启动，若修改代码需重新构建
docker-compose up frontend

五、配置 Chromedriver 路径（虚拟环境）

问题现象：

虚拟环境中执行 chromedriver 提示 “命令未找到”。

解决方案：

1. 编辑激活脚本
   路径：.\.venv\Scripts\activate.bat
   在文件末尾添加 Chromedriver 路径：

   set PATH=D:\chromedriver;%PATH%  # 替换为实际路径
   

2. 重新激活虚拟环境

   .venv\Scripts\activate
   

六、配置 Ollama 语言模型服务

1. 修改配置文件

路径：config.ini

操作：

确保 Ollama 地址正确（默认端口 11434）：

ollama_url = http://localhost:11434  # 若 Ollama 服务在其他主机或端口，需对应修改

2. 验证 Ollama 服务

在浏览器中访问 http://localhost:11434，若显示 API 文档则表示服务正常。

七、完整启动与验证

1. 启动所有服务

# 1. 启动 Docker 容器（Redis、搜索引擎、前端）
start_services.cmd

# 2. 启动后端服务（新终端窗口）
.venv\Scripts\activate
python api.py

 

 

2. 访问前端界面

打开浏览器，访问 http://localhost:3000

• 若显示界面且无 “后端未部署” 提示，说明部署成功。
• 若提示连接失败，检查浏览器开发者工具（F12）的网络请求，确认后端接口返回状态码 200。

3. 测试后端接口

在浏览器中访问 http://localhost:8001/health，应返回：

{"status": "healthy"}

八、常见问题与解决方案

问题	解决方案
Docker 容器启动失败（端口冲突）	修改 docker-compose.yml 端口映射，使用 netstat -ano 排查占用端口的进程。
后端配置文件编码错误	确保 config.ini 为 UTF-8 编码，或在代码中显式指定编码。
Chromedriver 无法找到	检查虚拟环境激活脚本中的路径是否正确，或直接将路径添加到系统环境变量。
Ollama 模型加载失败	确保 Ollama 服务运行，重启 Ollama 或更换模型（如 ollama run llama2）。

九、卸载与清理

# 停止并删除 Docker 容器
docker-compose down

# 退出虚拟环境
deactivate

# 删除虚拟环境（可选）
rmdir /s /q .venv

通过以上步骤，可在 Windows 系统中完成 AgenticSeek 的本地部署与配置。如有其他问题，可参考项目官方文档或提交 Issues 反馈。

十、参考资料

【笔记】Windows 下载并安装 ChromeDriver -CSDN博客

【笔记】解决虚拟环境中找不到 chromedriver 的问题-CSDN博客 

【笔记】部署 AgenticSeek 项目问题：端口 8000 被占用-CSDN博客