
如何5分钟上手Super Agent PartyWindows、Mac、Docker零基础上手完整部署教程【免费下载链接】super-agent-party⭐全能型AI伴侣AI桌面女友 AI虚拟主播 AI即时通讯机器人 AI浏览器 AI智能家居 AI游戏 等你能想到的一切功能项目地址: https://gitcode.com/heshengtao/super-agent-partySuper Agent Party超级智能体派对是一款开源的全能型AI桌面伴侣集AI桌面女友、VRM 3D桌宠、任务中心、AI即时通讯机器人、AI虚拟主播与AI浏览器于一体。这篇部署教程面向零基础用户带你用最短时间完成 Windows、Mac、Docker 三种平台的上手无需任何开发经验。一、Super Agent Party 能做什么在开始部署前先花30秒认识一下这位全能AI伴侣的核心能力功能模块说明️ VRM桌面伴侣自定义3D模型、动作、场景支持语音互动与对话打断 任务中心AI后台自动操控电脑完成高级任务支持 MCP 与 Agent Skills IM机器人一键部署到 QQ、微信、飞书、钉钉、Telegram、Discord、Slack 直播机器人支持 B站、YouTube、Twitch 一键开播支持360度全景直播 AI浏览器给AI智能体配备专属浏览器支持自动操控 多角色群聊支持酒馆角色卡与长期记忆同时和多个角色聊天桌面伴侣支持多种窗口模式聊天界面可以缩成手机大小、胶囊大小停靠在桌面任意角落随叫随到它不只是陪聊。任务中心能让 AI 智能体在后台自动执行高级任务、操控电脑帮你干活通过桌面视觉 鼠标键盘终端控制工具链AI 还能真正看懂屏幕并操作电脑部署完成后还能一键把它变成 QQ、微信等平台的 IM 机器人支持多角色群聊同时与多个角色支持长期记忆一起对话 硬件要求极低CPU 2核及以上、内存 2GB 及以上即可。模型全部可选——可接入本地部署引擎如 ollama也可全部使用云服务商接口2核2G 的云服务器跑 Docker 版本毫无压力。二、Windows 安装两种官方方式推荐整合包系统要求Windows 10/11或更新版本。方式1Windows 整合包官方推荐⭐免安装源码版本支持一键同步到仓库最新版本无需等待桌面版打包适合大多数用户从项目发布页下载 Windows 整合包zip解压到任意目录建议路径不含中文首次使用双击一键更新(update).bat自动同步最新依赖日常启动双击一键启动(start).bat即可方式2Windows 桌面版安装包从项目发布页下载Super-Agent-Party-Setup-0.4.2.exe双击安装即可。⚠️注意安装时请选择仅为当前用户安装否则启动软件时需要管理员权限。三、Mac 安装整合包与桌面版仅支持 M 芯片整合包三步走适合开发者/进阶用户移除网络下载隔离重要打开终端输入下面命令注意末尾有空格然后把解压后的文件夹拖进终端窗口回车sudo xattr -rd com.apple.quarantine-rd会递归移除文件夹内所有组件的隔离属性否则 Python 环境可能无法正常调用赋予脚本执行权限在终端进入该文件夹执行chmod x 一键更新(update).sh 一键启动(start).sh运行软件首次使用建议先执行./一键更新(update).sh日常启动直接执行./一键启动(start).shMac 桌面版dmg从项目发布页下载 dmg 安装包将 app 拖入/Applications目录然后打开终端执行以下命令输入 root 密码移除 Quarantine 隔离属性之后即可正常打开sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app四、Docker 部署服务器/无桌面环境首选Docker 版适合部署在服务器、NAS 上桌宠与聊天界面通过浏览器访问。方式1单容器一键启动国际用户Docker Hubdocker pull ailm32442/super-agent-party:latest docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest国内用户阿里云 ACR 镜像拉取更快docker pull crpi-9mgnqijkd7wc42x2.cn-shenzhen.personal.cr.aliyuncs.com/ailm32442/super-agent-party:latest docker run -d -p 3456:3456 -v ./super-agent-data:/app/data crpi-9mgnqijkd7wc42x2.cn-shenzhen.personal.cr.aliyuncs.com/ailm32442/super-agent-party:latest⭐./super-agent-data可替换为任意本地文件夹启动后所有数据都会缓存在这个本地文件夹不会上传到任何地方。启动完成后浏览器访问http://localhost:3456/即开箱即用。方式2Docker Compose 部署带登录网关这种方式会额外启动一个网关容器提供登录密码管理适合公网部署。配置文件见 docker-compose.yml国内用户可换成 docker-compose-acr.yml镜像拉取更快git clone https://gitcode.com/heshengtao/super-agent-party cd super-agent-party docker-compose up -d⭐ 初始用户名为root初始密码为pass首次登录后请修改密码。API Key 管理页面http://localhost:3456/token.html小贴士配合官方的 SAP-lite 轻量客户端还能把 Docker 版变回桌面端体验。五、源码部署开发者进阶如果你希望直接跑仓库源码参与开发只需三条命令需先安装 Python 与 Node.js 环境管理工具 uv、npmgit clone https://gitcode.com/heshengtao/super-agent-party cd super-agent-party uv sync npm install npm run dev也可以使用现成的启动脚本 start_with_dev.shWindows 用户用 start_with_dev.bat。项目结构参考Python 后端逻辑集中在 py/ 目录前端页面与资源在 static/默认设置模板为 config/settings_template.jsonDocker 镜像构建文件为 Dockerfile。六、首次运行3步开始与AI对话无论哪种部署方式启动后的流程完全一致配置模型接入在设置中选择模型服务商——支持 OpenAI 兼容接口、本地部署引擎如 ollama及各类云服务商接口填入 API Key 即可挑选你的AI伴侣形象为角色配置人设、声音与 VRM 形象聊天界面支持自定义背景图、表情包开始对话输入框或 IM 平台飞书、QQ、Telegram、Discord、Slack 等都支持快捷指令如/new清空会话、/model切换模型、/stop停止生成完整列表可在系统设置 → 快捷指令中查看对开发者来说它还开放了完美兼容 OpenAI 格式的 APIhttp://localhost:3456/v1与本地 MCP 服务http://127.0.0.1:3456/mcp无需修改调用代码就能把这位 AI 伴侣接入你自己的项目。七、常见问题速查问题解决方法Windows 启动报错系统需为 Windows 10/11安装版请确认安装时选择了仅为当前用户Mac 打开提示已损坏按上文执行sudo xattr -dr com.apple.quarantine移除隔离属性仅支持 M 芯片Docker 国内拉取慢换用阿里云 ACR 镜像地址见上文方式1端口 3456 被占用修改docker run的-p映射如-p 8080:3456想体验更多玩法前往【开发者】→【扩展】安装扩展如 AI 塔罗牌、AI 电子表格、音乐控制等更多完整功能与中文使用说明可查阅仓库内的 README_ZH.md零基础用户照着本文的顺序操作5分钟即可拥有自己的全能 AI 桌面伴侣 【免费下载链接】super-agent-party⭐全能型AI伴侣AI桌面女友 AI虚拟主播 AI即时通讯机器人 AI浏览器 AI智能家居 AI游戏 等你能想到的一切功能项目地址: https://gitcode.com/heshengtao/super-agent-party创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考