AgentVerse 保姆级部署教程：开源多智能体协作框架，多 LLM Agent 编排部署
AgentVerse（官方仓库 OpenBMB/AgentVerse）Facilitate deployment of multiple LLM-based agents。当前约 ~7.5k Star，采用 Apache-2.0 协议开源。本文基于官方 README 整理从零到一的完整部署与使用指南，适合想在本地或服务器快速搭建 AgentVerse 的开发者与技术团队。
一、项目介绍与适用场景
🤖 AgentVerse 🪐
A Framework for Multi-LLM Environment Simulation
git clone https://github.com/OpenBMB/AgentVerse.git
cd AgentVerse
# 按照官方 README 的依赖说明安装
# Python 项目示例：
pip install -r requirements.txt
# 或 Go 项目示例：
# go mod download
# 复制示例配置文件
cp config.example.yaml config.yaml
# 编辑 config.yaml 填入实际参数
# 至少需要修改数据库连接、端口号、认证密钥等必填项
# 如官方提供初始化脚本
python init_db.py
# 或按照 README 说明完成首次初始化
# 按照官方文档的启动命令运行
python main.py
# 或
# ./start.sh
# 如官方提供镜像
docker pull ghcr.io/OpenBMB/AgentVerse:latest
# 或使用 docker-compose
docker compose up -d
# 前台运行，日志直接输出到终端，便于调试
python main.py
[Unit]
Description=AgentVerse Service
After=network.target
[Service]
Type=simple
WorkingDirectory=/opt/AgentVerse
ExecStart=/usr/bin/python3 main.py
Restart=always
RestartSec=5
User=www-data
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable AgentVerse
sudo systemctl start AgentVerse
sudo systemctl status AgentVerse
docker run -d --name AgentVerse -p 8080:8080 -v /data/AgentVerse:/app/data --restart=unless-stopped ghcr.io/OpenBMB/AgentVerse:latest
curl http://localhost:8080/health
# 预期返回 200 或健康状态 JSON
# 查看 systemd 服务日志
journalctl -u AgentVerse -f
# 或查看应用日志文件
tail -f logs/app.log
# 拉取最新代码
git pull origin main
# 更新依赖
pip install -r requirements.txt --upgrade
# 备份配置与数据
cp -r config.yaml config.yaml.bak
cp -r data data.bak
# 重启服务
sudo systemctl restart AgentVerse
# 查看历史提交记录
git log --oneline -10
# 回滚到指定版本
git checkout
# 恢复配置与数据
cp config.yaml.bak config.yaml
cp -r data.bak data
# 重启服务
sudo systemctl restart AgentVerse
# 停止并禁用服务
sudo systemctl stop AgentVerse
sudo systemctl disable AgentVerse
# 删除服务文件
sudo rm /etc/systemd/system/AgentVerse.service
sudo systemctl daemon-reload
# 删除项目目录
rm -rf /opt/AgentVerse
# 如需删除数据
# rm -rf /data/AgentVerse