简介

🚀 一款拥有无限可能的AI桌面伴侣！

VRM桌面宠物：支持上传自定义VRM模型、动作和3D场景，打造个性化桌面伴侣。

任务中心：让您的AI智能体在后台执行任何高级任务，自动控制电脑完成工作，支持MCP和Agent Skills。

计算机控制：通过桌面视觉结合鼠标、键盘和终端控制工具链，AI智能体可以完成电脑上的任何任务！下图展示了一位AI正在玩Wordle游戏。

多角色群聊：支持酒馆角色卡和长期记忆功能，让您同时与多个角色聊天！

即时通讯机器人：支持一键部署到QQ、微信、飞书、钉钉、Telegram、Discord、Slack等平台。

直播机器人：支持一键部署到Bilibili、YouTube、Twitch等平台，并实现360度全景直播。

AI浏览器：为您的AI智能体配备专属浏览器，支持自动化控制。

扩展系统：支持安装和创建新扩展。下图展示了一个Galgame扩展。所有扩展都可以在独立窗口或侧边栏中打开。

开发者友好：提供开放的OpenAI API接口和MCP接口，允许智能体进行外部连接。

快速入门

中国用户下载请点击 中国用户点击下载 的链接！

Windows便携版（推荐！免安装源码版本，支持一键同步到仓库最新版本，无需等待桌面版打包）

👉 点击下载

👉 中国用户点击下载

⭐ 注意！您可以双击一键更新(update).bat来更新软件，也可以双击一键启动(start).bat来启动软件。操作系统必须是Windows 10/11、Windows Server 2025或更高版本！

Windows桌面安装版

👉 点击下载

👉 中国用户点击下载

⭐ 注意！安装时请仅选择为当前用户安装，否则启动时将需要管理员权限。操作系统必须是Windows 10/11、Windows Server 2025或更高版本！

MacOS集成包（目前仅支持M芯片，免安装源码版本，支持一键同步到最新仓库版本，无需等待桌面版打包）

适合开发者/高级用户：免安装源码版本，支持一键同步到最新仓库版本，无需等待桌面版打包。

👉 国际用户点击下载

👉 中国用户点击下载

🚀 使用步骤

1. 移除网络下载隔离（重要） 下载并解压后，打开终端，输入以下命令（注意末尾有一个空格），然后将解压后的文件夹拖入终端窗口并按回车键：

sudo xattr -rd com.apple.quarantine 

（注：-rd参数会递归地移除文件夹内所有组件的隔离属性；否则，Python环境可能无法正常运行。）

2. 赋予脚本执行权限 在终端中进入该文件夹，执行：

chmod +x 一键更新(update).sh 一键启动(start).sh

3. 运行软件

• 首次使用/更新：建议先执行./一键更新(update).sh，以确保依赖项同步到最新版本。
• 日常启动：直接执行./一键启动(start).sh。

MacOS桌面安装版（目前仅支持M芯片。）

👉 点击下载

👉 中国用户点击下载

⭐ 注意！下载完成后，将dmg文件中的应用拖入/Applications目录，然后打开终端，执行以下命令并输入root密码，以移除网络下载附带的隔离属性：

sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app

Linux 桌面安装

我们提供了两种主流的 Linux 安装包格式，以方便您在不同场景下使用。

1. 使用 .AppImage 安装

.AppImage 是一种无需安装即可直接使用的 Linux 应用程序格式，适用于大多数 Linux 发行版。

👉 点击下载

2. 使用 .deb 包安装（适用于 Ubuntu/Debian 系统）

👉 点击下载

Docker 部署（此版本的桌面宠物仅可通过浏览器查看。）

• 两条命令即可安装该项目：

  docker pull ailm32442/super-agent-party:latest
  docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest
  

• ⭐注意！./super-agent-data 可以替换为任何本地文件夹，Docker 启动后，所有数据都将缓存在此本地文件夹中，不会上传到任何地方。

• 即可使用：访问 http://localhost:3456/

Docker Compose 部署（此版本的桌面宠物仅可通过浏览器查看。将额外启动一个网关容器用于登录管理。）

• 安装项目：

  git clone https://github.com/heshengtao/super-agent-party.git
  cd super-agent-party
  docker-compose up -d
  

• ⭐注意！默认用户名为 root，默认密码为 pass。请在首次登录后更改密码。

• 即可使用：访问 http://localhost:3456/

• API 密钥管理：访问 http://localhost:3456/token.html

与您的 Docker 版本匹配的轻量级客户端，将 Docker 转变为桌面应用

👉 SAP-lite-Windows-exe

👉 SAP-lite-MacOS-dmg

源代码部署

git clone https://github.com/heshengtao/super-agent-party.git
cd super-agent-party
uv sync
npm install
npm run dev

扩展功能

新增了全新的扩展系统。您可以在 插件列表 查看可用插件，或直接在聚会中通过【开发者】->【扩展】进行查看和安装。您也可以将自己开发的扩展添加到官方插件列表中，网址为 super-agent-party.github.io！

现有扩展

名称	作者	描述	仓库地址
Super Agent Party 示例	heshengtao	Super Agent Party 的示例插件，展示插件架构和功能。	https://github.com/heshengtao/sap-example
带 NodeJS 的 Super Agent Party 示例	heshengtao	这是一个带有 NodeJS 环境的聊天前端示例	https://github.com/heshengtao/sap-example-with-node
Web 预览	heshengtao	一个使 Super Agent Party 具备网页预览功能的插件。	https://github.com/heshengtao/sap-web-preview
故事冒险	heshengtao	一款交互式故事冒险插件，利用 AI 生成故事情节和选项。	https://github.com/heshengtao/sap-story-adventure
Live 2D	heshengtao	这是一个 Live 2D 扩展	https://github.com/heshengtao/sap-live2d
AI 编辑器	heshengtao	这是一个 AI 编辑器	https://github.com/heshengtao/sap-aieditor
AI galgame	heshengtao	这是一个 AI galgame 扩展	https://github.com/heshengtao/sap-aigalgame
AI 塔罗牌解读	heshengtao	这是一个 AI 塔罗牌解读扩展	https://github.com/heshengtao/sap-tarot
AI 表格	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 阅读器	heshengtao	这是为 Super Agent Party 提供的 AI RSS 阅读器扩展	https://github.com/heshengtao/sap-rss
远程	heshengtao	一键将 Super Agent Party 暴露于公共互联网	https://github.com/heshengtao/sap-remote
代码服务器	heshengtao	Super Agent Party 的 IDE 扩展	https://github.com/heshengtao/sap-code-server
CLI	heshengtao	Super Agent Party 的 CLI 扩展	https://github.com/heshengtao/sap-cli

硬件要求

• CPU：2 核或以上
• 内存：2GB 或以上

由于所有模型均为可选，您可以选择本地部署引擎，也可以全部使用云服务提供商的接口，因此硬件要求较低。我们在一台 2 核 2G 的云服务服务器上测试了 Docker 版本，运行良好。

使用方法

• 桌面版：单击桌面图标即可立即使用。

• Web 或 Docker 版：启动后访问 http://localhost:3456/。

• API 调用：对开发者友好，完全兼容 OpenAI 格式，可实时输出，且不会影响原 API 的响应速度。无需修改调用代码：

  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 服务：

  {
    "mcpServers": {
      "super-agent-party": {
        "url": "http://127.0.0.1:3456/mcp",
      }
    }
  }
  

功能特性

主要功能请参阅以下文档：

• 👉 中文文档
• 👉 英文文档

功能	详情
支持的模型服务提供商	支持常见的本地部署引擎接口和云服务商接口，例如：openai/ollama/dify 等。
多模态模型集成	集成角色扮演、推理、视觉、图像生成、语音识别、语音合成等多种类型模型，实现组合使用。
VRM 桌面宠物机器人	高度可定制，支持自定义头像、自定义动画、语音交互和对话打断。可无缝推流至 OBS 等录屏软件，并支持双向 VMC 协议！
消息平台机器人	目前支持 QQ、微信、飞书、Telegram、Discord、Slack 等，后续还将增加更多平台。
直播机器人	目前支持 Bilibili、YouTube、Twitch 等，后续还将增加更多平台。
播报机器人	支持长文本朗读、多音色朗读、数字人视频播报、超长文本批量转语音（并可下载）等功能，同时支持解析 EPUB 等常见电子书格式。分章节转换功能将在后续开发。
聊天界面	聊天界面支持 A2UI、数学公式、Mermaid 图表、HTML 代码图形等前端渲染功能。图片可下载或复制。支持胶囊模式和助理模式，方便收起并停靠对话界面。结合桌面视觉与截图功能，可无缝融入工作与娱乐场景。
角色扮演	支持酒馆角色卡的上传、编辑和下载。允许为不同角色配置不同的声音和头像。具备长期记忆功能，在使用角色卡时支持多音色，非角色文本可由旁白音色朗读，并支持表情符号和梗图。
丰富的原生工具	工具调用支持异步执行，包括网页搜索、知识库访问、智能家居控制、浏览器控制、沙箱环境下的代码执行、控制 ComfyUI 进行图像生成，以及 Claude 代码操作文件系统等。
自定义工具接口	支持 MCP、Skills、A2A、HTTP 请求，以及任何 LLM 接口作为主智能体的工具，用户可自由定制其智能体的工具链。
开放外部 API	对开发者友好，开放模拟 OpenAI 和 MCP 的 API，以及桌面宠物 API。
扩展系统	您可以在扩展列表中查看可用插件。也可直接在 Party 中通过【开发者】 -> 【扩展】来浏览和安装插件。您还可以将自己开发的扩展添加到官方扩展列表中，网址为super-agent-party.github.io!
存储空间	所有文件和数据均存储在用户的本地数据文件夹中。当与 NAS 部署时，还可作为本地网络内的个人图片或文件托管服务器。

免责声明：

本开源项目及其内容（以下简称“项目”）仅供参考，不构成任何明示或暗示的保证。项目贡献者不对项目的完整性、准确性、可靠性或适用性承担任何责任。任何依赖项目内容的行为均由用户自行承担风险。在任何情况下，项目贡献者均不对因使用项目内容而产生的间接、特殊或附带损失或损害承担责任。

特别说明

1. 本开源项目中的某些功能（如 Edge TTS 语音合成等）依赖于第三方服务提供的公共接口或实验性功能。这些功能可能因第三方政策变更而随时不可用。开发者对这些功能的稳定性、合法性及持续性不承担任何责任。使用本项目即表示用户已理解并同意自行承担相关风险。开发者不建议也不鼓励将这些功能用于商业或大规模部署场景。

2. 本 QQ 机器人使用官方 QQ 机器人接口，请遵守《AIGC QQ 机器人使用规范》（链接：https://q.qq.com/#/news/detail?id=1376238e8e2fbbc036676bb09d2f37da）。

3. 本项目提供的浏览器控制功能是一个基于大语言模型（LLM）的辅助浏览界面，旨在帮助视障人士、老年人或行动不便者通过自然语言指令，结合 AI 视觉识别技术，更便捷地操作浏览器。该功能并非用于自动化爬取或黑客攻击目的。项目采用“LLM 视觉推理 → 单步操作”的技术架构。辅助浏览界面具有以下特点：
   a. 非高频并发：由于依赖 LLM 推理速度（每步需 3–5 秒），并内置随机化的人类行为延迟算法，工具的操作频率严格低于普通人类用户的最高手动操作速度。
   b. 不会对服务器造成压力：该工具不支持多线程并发、批量数据抓取或 DDoS 攻击。从服务器视角来看，其行为与普通人类用户无异，不会对目标网站的服务器造成额外负载。

4. 请勿在银行、支付网关或涉及高度机密信息的页面上使用本项目。因用户操作不当导致的隐私泄露，开发者概不负责。禁止的行为包括大规模数据抓取、绕过安全机制、网络干扰以及违反法律法规等。

5. 本项目中出现的任何第三方商标、标识或品牌名称（包括但不限于 OpenAI、Microsoft、Google、Bing、Bilibili 等）均属于其各自所有者的财产。这些标识仅出于方便用户识别所使用的模型或服务之目的而展示，并不意味着与这些权利人存在任何官方关联、赞助或背书关系。若相关商标、界面或品牌的所有者认为本项目的使用不当，或不希望其品牌标识/界面通过本软件被展示或访问，请通过 GitHub Issues 或 hst97@qq.com 联系仓库管理员。我们将在收到通知后尽快（通常在 48 小时内）按照要求移除、删除或修改相关内容。

6. 本项目为独立开发的开源工具。用户在使用本软件访问第三方 API 服务时，须自行遵守相关服务提供商的使用条款。

7. 本软件通过第三方大模型生成的任何内容，其准确性、完整性及合规性均由模型提供商和用户行为负责。本软件作者对该等内容不承担任何法律责任。

许可协议

本项目采用双重许可模式：

1. 默认情况下，本项目遵循 GNU Affero 通用公共许可证 v3.0 (AGPLv3) 许可协议。
2. 如需将本项目用于闭源商业用途，必须获得项目管理员的商业授权。商务合作：hst97@qq.com。

未经书面授权而将本项目用于闭源商业用途，将被视为违反本协议。AGPLv3 的完整文本可在项目根目录下的 LICENSE 文件中找到，或访问 gnu.org/licenses 查阅。

第三方许可声明

本项目可能包含或依赖于某些第三方库或组件，其许可协议可能与主项目不同。为遵守相关许可要求，您可以在项目根目录下的 LICENSE-third-party 文件夹中，或在相应组件的源代码中找到这些第三方组件的许可信息。

我们衷心感谢所有第三方库和组件的贡献者，并承诺尊重他们的许可条款。

支持：

请为我们点亮星标！

⭐您的支持是我们不断前进的动力！

关注我们

加入社区

如您对项目有任何疑问或问题，欢迎加入我们的社区。

1. QQ 群：931057213

2. 微信群：we_glm（添加助理微信后即可入群）

3. Discord：Discord 链接

贡献者

星标历史

Super-Agent-Party 快速上手指南

Super-Agent-Party 是一款功能强大的 AI 桌面伴侣，支持 VRM 桌面宠物、自动化任务执行、电脑视觉控制、多角色群聊及多种即时通讯/直播机器人部署。

1. 环境准备

系统要求

• Windows: Windows 10 / 11 / Server 2025 或更高版本。
• macOS: 仅支持 Apple Silicon (M 系列芯片)。
• Linux: 主流发行版（推荐 Ubuntu/Debian）。
• Docker: 任意支持 Docker 的平台（桌面宠物需通过浏览器访问）。

前置依赖

• 源码部署需安装:
  • Python (推荐使用 uv 管理)
  • Node.js & npm
• Docker 部署需安装:
  • Docker Engine
  • Docker Compose (可选)

提示：普通用户建议直接下载预编译包，无需配置开发环境。

---

2. 安装步骤

方案 A：Windows 用户（推荐）

免安装便携版（首选）

支持一键同步最新代码，无需等待官方打包新版本。

1. 下载（国内用户加速链接）： 点击下载便携版
2. 解压后双击运行：
   • 首次使用或更新：双击 一键更新 (update).bat
   • 日常启动：双击 一键启动 (start).bat

桌面安装版

1. 下载（国内用户加速链接）： 点击下载安装包
2. 运行安装程序，注意：安装时请选择“仅为当前用户安装”，否则启动时需要管理员权限。

---

方案 B：macOS 用户（仅限 M 系列芯片）

免安装便携版（开发者推荐）

1. 下载（国内用户加速链接）： 点击下载便携版
2. 解除网络隔离限制（重要）： 打开终端，输入以下命令（注意末尾有空格），然后将解压后的文件夹拖入终端窗口并回车：

   sudo xattr -rd com.apple.quarantine 
   

3. 赋予执行权限： 在终端进入该文件夹，执行：

   chmod +x 一键更新 (update).sh 一键启动 (start).sh
   

4. 运行：
   • 首次使用/更新：./一键更新 (update).sh
   • 日常启动：./一键启动 (start).sh

桌面安装版

1. 下载 .dmg 文件并将应用拖入 /Applications 目录。
2. 解除网络隔离：

   sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app
   

---

方案 C：Docker 部署（跨平台/服务器）

此模式下桌面宠物需通过浏览器访问。

快速启动

docker pull ailm32442/super-agent-party:latest
docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest

注：./super-agent-data 可替换为任意本地路径用于持久化数据。

访问地址

启动完成后，浏览器访问：http://localhost:3456/

---

方案 D：源码部署（开发者）

适用于需要修改源码或贡献代码的用户。

git clone https://github.com/heshengtao/super-agent-party.git
cd super-agent-party
uv sync
npm install
npm run dev

---

3. 基本使用

安装启动成功后，您将看到主界面。以下是核心功能的最简使用流程：

3.1 配置 AI 模型

1. 点击设置或模型配置区域。
2. 填入您的 API Key（支持 OpenAI 兼容接口、本地大模型等）。
3. 选择模型并测试连接。

3.2 创建桌面宠物 (VRM)

1. 进入 VRM Desktop Pet 模块。
2. 上传自定义的 .vrm 模型文件、动作文件及 3D 场景。
3. 点击启动，宠物将出现在桌面并可交互。

3.3 启用电脑控制 (Computer Control)

1. 进入 Task Center 或 Computer Control 模块。
2. 确保已授权屏幕录制和辅助功能权限（macOS/Windows 需在系统设置中开启）。
3. 在对话框输入指令，例如：“帮我打开计算器并计算 123+456"或“玩一局 Wordle"。
4. AI 将自动操控鼠标、键盘完成任务。

3.4 扩展功能

• 插件安装：点击菜单栏【Developer】->【Extensions】，浏览并安装官方插件（如 AI 绘图、塔罗牌、Galgame 等）。
• 多端部署：在设置中选择 IM Bot 或 Live Streaming Bot，按照指引绑定 QQ、微信、B 站等账号即可实现一键托管。