零基础部署AgenticSeek教程：硬件要求与系统配置完全指南

【免费下载链接】agenticSeek A open, local Manus AI alternative. Powered with Deepseek R1. No APIs, no $456 monthly bills. Enjoy an AI agent that reason, code, and browse with no worries. 项目地址: https://gitcode.com/GitHub_Trending/ag/agenticSeek

AgenticSeek是一款开源本地AI助手，可替代Manus AI，支持自主网页浏览、代码编写和任务规划，所有数据均存储在本地设备上。本教程将详细介绍从零开始部署AgenticSeek的硬件要求、系统配置及完整步骤，帮助普通用户顺利完成安装。

硬件要求与系统环境

部署AgenticSeek前，需确保硬件和系统满足以下条件：

最低硬件配置

• CPU：四核及以上处理器
• 内存：16GB RAM（推荐32GB及以上）
• 存储：至少20GB可用空间（SSD为佳）
• 显卡：若本地运行LLM（大语言模型），需支持Magistral、Qwen或Deepseek 14B模型的GPU，如NVIDIA RTX 3060及以上

支持的操作系统

• Linux（Ubuntu 20.04+、Debian 11+）
• macOS（10.15+）
• Windows（10+）

安装前准备

在开始部署前，需安装以下必要软件：

核心依赖

• Git：用于克隆代码仓库
• Python 3.10.x：推荐使用Python 3.10版本，避免依赖错误
• Docker Engine & Docker Compose：用于运行SearxNG等服务

软件安装方法

Git安装

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install git -y

# macOS (使用Homebrew)
brew install git

# Windows
# 从 https://git-scm.com/downloads 下载安装程序

Python 3.10安装

# Ubuntu/Debian
sudo apt-get install python3.10 python3.10-venv python3.10-dev -y

# macOS (使用pyenv)
pyenv install 3.10.0
pyenv local 3.10.0

# Windows
# 从 https://www.python.org/downloads/release/python-3100/ 下载安装程序

Docker安装

# Ubuntu/Debian
sudo apt-get install docker.io docker-compose-plugin -y
sudo systemctl enable --now docker

# macOS/Windows
# 从 https://docs.docker.com/desktop/ 下载Docker Desktop

部署步骤

1. 克隆代码仓库

git clone https://gitcode.com/GitHub_Trending/ag/agenticSeek.git
cd agenticSeek

2. 配置环境变量

# 复制环境变量示例文件
mv .env.example .env

# 编辑.env文件，设置必要参数
nano .env

关键配置项说明：

• WORK_DIR：工作目录路径，AgenticSeek将在此读写文件
• OLLAMA_PORT：Ollama服务端口（默认11434）
• LM_STUDIO_PORT：LM Studio服务端口（默认1234）

3. 安装依赖

根据操作系统选择对应的安装脚本：

Linux

./scripts/linux_install.sh

macOS

./scripts/macos_install.sh

Windows

scripts\windows_install.bat

4. 配置LLM模型

AgenticSeek支持多种本地LLM提供商，推荐使用Ollama或LM Studio：

Ollama配置

# 启动Ollama服务
export OLLAMA_HOST=0.0.0.0:11434
ollama serve

# 下载并运行模型（新终端）
ollama pull deepseek-r1:14b

配置文件修改

编辑config.ini文件，设置LLM提供商和模型：

[MAIN]
is_local = True
provider_name = ollama
provider_model = deepseek-r1:14b
provider_server_address = 127.0.0.1:11434

5. 启动服务

# 使用Docker Compose启动所有服务
docker-compose up -d

# 启动后端服务
./start_services.sh full

服务启动后，访问http://localhost:3000即可打开AgenticSeek web界面。

验证部署

检查服务状态

# 检查Docker服务状态
docker-compose ps

# 检查后端服务日志
docker logs -f backend

基本功能测试

1. 打开web界面http://localhost:3000
2. 输入测试命令：搜索2025年热门AI新闻，并保存到ai_news.txt
3. 检查工作目录下是否生成ai_news.txt文件

常见问题解决

ChromeDriver版本不兼容

若出现ChromeDriver错误，需下载与Chrome浏览器版本匹配的驱动：

# 查看Chrome版本
google-chrome --version

# 下载对应版本ChromeDriver
# 地址：https://googlechromelabs.github.io/chrome-for-testing/

将下载的ChromeDriver放在项目根目录或系统PATH中。

内存不足问题

• 降低模型大小，如使用7B模型代替14B
• 增加系统交换空间
• 关闭其他占用内存的应用程序

服务启动失败

检查端口是否被占用：

# 检查3000端口
netstat -tulpn | grep 3000

若端口被占用，可修改配置文件中的对应端口。

总结与后续优化

通过以上步骤，您已成功部署AgenticSeek本地AI助手。为获得更好体验，建议：

1. 增加系统内存至32GB以上
2. 使用NVIDIA GPU加速（至少6GB显存）
3. 定期更新代码和模型：

git pull
ollama pull deepseek-r1:14b

官方文档：README.md
技术文档：docs/CODE_OF_CONDUCT.md
安装脚本：scripts/

【免费下载链接】agenticSeek A open, local Manus AI alternative. Powered with Deepseek R1. No APIs, no $456 monthly bills. Enjoy an AI agent that reason, code, and browse with no worries. 项目地址: https://gitcode.com/GitHub_Trending/ag/agenticSeek