项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- 已安装 Docker(使用 Docker / Docker Compose 部署时)
- 本机 3456 端口可用(容器需映射该端口)
- 源码部署需 uv 与 npm(Node.js)环境
- Windows 安装包需 Windows 10/11、Windows Server 2025 或更高版本
安装与启动步骤
-
1拉取镜像
从 Docker Hub 拉取 Super Agent Party 最新镜像,执行前请确认 Docker 已安装并可用。
docker pull ailm32442/super-agent-party:latest -
2启动容器
后台运行容器,把 3456 端口映射到本机,并将数据持久化到本地 ./super-agent-data 目录。
docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest -
3浏览器访问
容器启动后在浏览器打开该地址即可使用;Docker 版本的桌面宠物只能通过浏览器查看。
-
4Compose 部署
可选方式:克隆仓库后在项目目录用 docker-compose 启动,会额外启动一个网关容器用于登录管理。
git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d -
5源码部署
可选方式:克隆仓库后用 uv 同步依赖、npm 安装依赖,再启动开发服务。
git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
MCP 服务 url | 否 | 在 MCP 客户端配置文件的 mcpServers 中填写,用于调用本地 MCP 服务 | http://127.0.0.1:3456/mcp |
base_url | 否 | OpenAI 兼容接口地址,无需改动原有调用代码 | http://localhost:3456/v1 |
api_key | 否 | 调用 OpenAI 兼容接口时使用的密钥 | super-secret-key |
如何确认成功
浏览器打开 http://localhost:3456/ 能正常加载界面,即表示启动成功。
常见问题
Q:Docker 版本的桌面宠物在哪里看?
A:Docker 部署的版本桌面宠物只能通过浏览器查看,启动后访问 http://localhost:3456/ 即可使用。
Q:如何用现有 OpenAI 代码调用?
A:把 base_url 改成 http://localhost:3456/v1,api_key 填 super-secret-key,模型名用 super-model,无需修改调用代码。
Q:怎样调用本地 MCP 服务?
A:启动后在 MCP 客户端配置文件中写入 mcpServers,url 填 http://127.0.0.1:3456/mcp 即可。
Q:macOS 下载后无法运行怎么办?
A:先在终端执行 sudo xattr -rd com.apple.quarantine 移除隔离属性,再 chmod +x 给脚本执行权限。
Q:Windows 便携版怎么启动和更新?
A:双击 一键更新(update).bat 同步最新版本,双击 一键启动(start).bat 启动软件。
注意事项
- Docker 版桌面宠物只能通过浏览器查看,需要类似桌面应用可搭配 SAP-lite 客户端。
- macOS 集成包与桌面安装目前仅支持 M 芯片。
- Windows 桌面安装时请选择仅当前用户安装,否则启动需要管理员权限。
- Windows 便携版要求 Windows 10/11、Windows Server 2025 或更高版本。
核心亮点
- 整合 AI VTuber 直播、IM 机器人和桌面智能体于一体,功能覆盖广
- 支持 MCP 和 agent-skills,可扩展工具调用能力
- 自托管部署,数据隐私可控,不依赖单一云服务
不足之处
- 项目处于成长阶段,文档和社区生态尚待完善
- 功能模块多,初次部署和配置门槛可能较高
适用场景
- 搭建个人 AI VTuber 进行直播互动
- 在 Discord 或 IM 中部署可执行任务的聊天机器人
- 用自然语言控制 Home Assistant 智能家居设备
替代项目
Neuro-sama、Open Interpreter
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
