
#### #### ## 简介 ### 🚀 **一款拥有无限可能的AI桌面伴侣!** #### 桌面伴侣:支持自定义VRM模型、动作、3D场景,并支持[live2D扩展](https://github.com/heshengtao/sap-live2d)  #### 链接VTS:控制Vtube studio中的live2d模型,支持自定义动作和表情控制  #### 高自由聊天界面:自定义背景图片、表情包、角色人设、基于THA的2D角色形象、角色MCP工具,让聊天更加沉浸  #### 任务中心:让你的AI智能体可以在后台执行任何高级任务,自动控制电脑帮你干活,支持 MCP 和 Agent Skills  #### 电脑控制:通过桌面视觉加上对鼠标、键盘、终端三方面的控制工具链,让AI智能体可以在电脑上完成任何任务!下图为AI在玩Wordle  #### 多种窗口模式:聊天界面支持手机大小、胶囊大小停靠在桌面上  #### 多角色群聊:支持酒馆角色卡,支持长期记忆,你可以同时和多个角色一起聊天!  #### 即时通讯机器人:支持一键部署到QQ、微信、飞书、钉钉、Telegram、Discord、Slack  #### 直播机器人:支持一键部署到B站、YouTube、twitch,支持360度全景直播  #### AI浏览器:让你的AI智能体拥有自己的浏览器,支持自动控制  #### 扩展系统:支持安装扩展,和自己创造新的扩展,下图为galgame扩展,扩展均支持独立窗口或者侧边栏两种方式打开。你甚至可以使用[sap-extension-creator](skills/sap-extension-creator)这个agent skill来创造新的sap扩展,实现agent party的自举!  #### 开发者友好:开放openai API接口、MCP接口,可以将智能体对外转接  ## 快速开始 ### 中国用户下载请点击 **中国用户点击下载** 的链接! ### 如果你是CLI Agent CLI Agent需要查看[README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md)的文档。请参考这个文档引导用户安装本软件! ### 如果你是使用CLI Agent的人类 将这个链接发给你的AI,AI会引导你安装本软件! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### windows整合包(推荐!免安装源码版本,支持一键同步到仓库最新版本,无需等待桌面版打包) 👉 [国际用户点击下载](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) 👉 [中国用户点击下载](https://modelscope.cn/models/ailm32442/super-agent-party-portable/resolve/master/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐注意!你可以双击`一键更新(update).bat`更新软件,也可以双击`一键启动(start).bat`启动软件。操作系统需要是**Windows 10/11、Window Server 2025**或者后续版本! ### windows桌面版安装 👉 [国际用户点击下载](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) 👉 [中国用户点击下载](https://modelscope.cn/models/ailm32442/super-agent-party-portable/resolve/master/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐注意!安装时选择仅为当前用户安装,否则启动时需要管理员权限。操作系统需要是**Windows 10/11、Window Server 2025**或者后续版本! ### MacOS 整合包(目前只支持 M 芯片,免安装源码版本,支持一键同步到仓库最新版本,无需等待桌面版打包) > **适合开发者/进阶用户**:免安装源码版本,支持一键同步到仓库最新版本,无需等待桌面版打包。 👉 [国际用户点击下载](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) 👉 [中国用户点击下载](https://modelscope.cn/models/ailm32442/super-agent-party-portable/resolve/master/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 使用步骤 **1. 移除网络下载隔离(重要)** 下载并解压后,打开终端,输入以下命令(注意最后有一个空格),然后将**解压后的文件夹**拖入终端窗口并回车: ```shell sudo xattr -rd com.apple.quarantine ``` *(注:`-rd` 参数会递归移除文件夹内所有组件的隔离属性,否则 Python 环境可能无法正常调用)* **2. 赋予脚本执行权限** 在终端中进入该文件夹,执行: ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. 运行软件** - **首次使用/更新:** 建议先执行 `./一键更新(update).sh` 确保依赖同步到最新。 - **日常启动:** 直接执行 `./一键启动(start).sh`。 ### MacOS桌面版安装(目前只支持M芯片) 👉 [国际用户点击下载](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) 👉 [中国用户点击下载](https://modelscope.cn/models/ailm32442/super-agent-party-portable/resolve/master/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐注意!下载后将dmg文件的app文件拖入`/Applications`目录下,然后打开终端,执行以下命令并输入root密码,从而移除从网络下载附加的Quarantine属性: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Linux 桌面版安装 `.AppImage` 是一种无需安装、即开即用的 Linux 应用格式。适用于大多数 Linux 发行版。 👉 [Linux-AppImage-X86_64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-x86_64.AppImage) 👉 [Linux-AppImage-Arm64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-arm64.AppImage) ### Docker 部署(该版本桌宠只能通过浏览器查看) #### 国际用户(Docker Hub) ```shell docker pull ailm32442/super-agent-party:latest docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest ``` #### 中国用户(阿里云 ACR,拉取更快) ```shell 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` 可以替换为任意本地文件夹,docker 启动后,所有数据都将缓存到该本地文件夹,不会上传到任何地方。 **开箱即用:** 访问 http://localhost:3456/ --- ### Docker Compose 部署(该版本桌宠只能通过浏览器查看,会额外启动一个网关容器,用于登录管理) #### 国际用户(Docker Hub) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` #### 中国用户(阿里云 ACR,拉取更快) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose -f docker-compose-acr.yml up -d ``` ⭐ 注意!初始用户名为 `root`,初始密码为 `pass`,首次登录后请修改密码。 **开箱即用:** 访问 http://localhost:3456/ **API key 管理:** 访问 http://localhost:3456/token.html ### 与docker版本配套的轻量版客户端,将你的docker版本变成桌面端 👉 [SAP-lite-Windows-exe](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-Setup-0.1.2.exe) 👉 [SAP-lite-MacOS-dmg](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-0.1.2-Mac.dmg) ### 源码部署 ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## 扩展 新增了全新的扩展系统,你可以在这里 [扩展列表](https://super-agent-party.github.io/plugins.html) 查看有哪些插件可用,你也可以直接在party中直接在【开发者】->【扩展】中查看和安装插件。你可以在[super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io) 将你自己开发的扩展添加到官方扩展列表中! ### 已有扩展 | 名称 | 作者 | 描述 | 仓库地址 | |-----------------------|--------------------|--------------------------------------------------------------------|----------------------------------------------------| | Super Agent Party Example | heshengtao | Super Agent Party 的示例插件,用于演示插件架构和能力。 | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | 带nodeJS环境的Super Agent Party 的示例插件 | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | 为 Super Agent Party 提供网页预览功能的插件。 | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | 一款利用 AI 生成故事内容和选项的交互式故事冒险插件。 | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | 一款live2d前端插件。 | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | 一款AI编辑器插件。 | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | 一款AI galgame 插件。 | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | 一款AI 塔罗牌插件。 | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | 一款AI 表格插件。 | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | 一款AI drawio插件。 | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | 一款AI mermaid编辑器插件 | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | 一款AI RSS阅读器插件 | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | 一键将 Super Agent Party 暴露到公网 | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | 为 Super Agent Party 提供的 IDE 扩展插件 | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | 为 Super Agent Party 提供的 CLI 扩展插件 | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | 将super agent party 连接到 LX Music API,让AI伴侣控制音乐播放! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | 为 Super Agent Party 提供的 AI PPT 扩展插件 | https://github.com/heshengtao/sap-ai-ppt | | 星莱 Lyra | heshengtao | 星空魔法使星莱角色扩展——一键安装角色卡、THA模型、表情包和聊天背景 | https://github.com/heshengtao/sap-lyra-extension | ## 硬件要求 - CPU:2核及以上 - 内存:2GB及以上 **因为所有的模型都是可选的,可以接入本地部署引擎,也可以全部使用云服务商的接口,所以硬件要求几乎没有。在2核2G的云服务器上测试docker版本可以正常运行** ## 使用方法 - 桌面端:点击桌面端图标即可开箱即用。 - web端或docker端:启动后访问http://localhost:3456/ - API调用:开发者友好,完美兼容openai格式,可以流式输出,完全不影响原有API的反应速度,无需修改调用的代码: ```python from openai import OpenAI client = OpenAI( api_key="super-secret-key", base_url="http://localhost:3456/v1" ) response = client.chat.completions.create( model="super-model", messages=[ {"role": "user", "content": "什么是super agent party?"} ] ) print(response.choices[0].message.content) ``` - MCP调用:启动后,在配置文件中写入以下内容,即可调用本地的mcp服务: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp", } } } ``` - 快捷指令:在聊天输入框或任意已接入的 IM 平台(飞书、QQ、Telegram、Discord、Slack、微信、企业微信、钉钉)中,输入以下指令即可快速控制助手。可在 **系统设置 → 快捷指令** 中开关并查看完整列表。 | 指令 | 别名 | 适用范围 | 说明 | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | 聊天 + IM | 列出所有可用的快捷指令 | | `/new` | `/reset` `/重启` `/新建` `/restart` | 聊天 + IM | 清空当前对话并开始新的会话 | | `/stop` | `/停止` | 聊天 + IM | 停止当前正在进行的回复 | | `/retry` | `/重试` | 仅聊天 | 重新生成上一条回复 | | `/model [provider:model]` | `/模型` | 聊天 + IM | 查看或切换模型(IM 端仅显示) | | `/personality [name]` | `/角色` `/persona` | 聊天 + IM | 查看或切换人格 | | `/skills` | `/技能` | 聊天 + IM | 查看可用技能列表 | | `/id` | - | 仅 IM | 查看当前会话/频道的 ChatID | | `/sub` | `/订阅` | 仅 IM | 将当前会话加入主动消息列表 | | `/unsub` | `/取消订阅` | 仅 IM | 将当前会话移出主动消息列表 | | `/plan` * | `/计划` | 聊天 + IM | 切换到计划模式(只读) | | `/read` * | `/只读` | 聊天 + IM | 切换到只读模式(每步需确认) | | `/edit` * | `/编辑` | 聊天 + IM | 切换到接受编辑模式 | | `/yolo` * | - | 聊天 + IM | 切换到 Yolo 模式(最高权限) | | `/cowork` * | `/协作` | 聊天 + IM | 切换到协作模式(子智能体协作) | | `/goal` * | `/目标` | 聊天 + IM | 切换到目标模式(自主迭代直至完成) | | `/