README_ZH.md · main · shijian_yiqiang/super-agent-party-1

shijian_yiqiang/super-agent-party-1

Public

WeChat Login

Code Issues Pull requests Events Packages Insights

main

super-agent-party-1/README_ZH.md

heshengtao<hst97@qq.com>

Merge branch 'dev' of https://github.com/heshengtao/super-agent-party into dev

7bfd6cdc

PreviewCode viewBlame

Raw

简介

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

✅ 全渠道一键部署：支持将智能体配置快速部署至多类终端，已兼容经典聊天界面、桌宠机器人、QQ、飞书、discord、telegram聊天机器人、B站、YouTube、twitch直播机器人等场景，开箱即用。
✅ 生态工具互联：可自由接入第三方智能体与工作流作为工具链（已适配Home Assistant/Claude code/Qwen code/Dify/ComfyUI/MCP/A2A等系统），通过agent-party架构实现跨平台能力聚合。
✅ 扩展生态丰富：支持自定义扩展开发，通过官网的扩展市场实现社区共享，满足个性化需求。
✅ 标准化接口开放：提供OpenAI API兼容接口及MCP协议支持，便于开发者直接对接外部系统，实现智能体能力的快速转接与二次开发。VRM桌宠开放了VMC协议，实现跨应用动作同步。VRM桌宠界面支持了webXR协议，你可以在支持XR的设备中沉浸式体验。
✅ 无缝能力增强：无需代码改造即可实现LLM API企业级升级，为现有模型接口无缝集成知识库、实时联网、永久记忆、兼容酒馆(SillyTavern)角色卡、代码执行、多模态能力（视觉/绘图/听觉/语音）、自动化能力（控制智能家居、控制浏览器）、深度思考控制与研究等模块化功能，打造可插拔的LLM增强中台。
✅ 全平台兼容适配：覆盖Windows/macOS/Linux原生运行环境，支持Docker容器化部署与Web端云服务，满足多场景技术栈需求。

快速开始

网盘下载

👉 点击百度云下载

👉 点击谷歌云下载

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

👉 点击下载

⭐注意！你可以双击一键更新(update).bat更新软件，也可以双击一键启动(start).bat启动软件。

windows桌面版安装

👉 点击下载

⭐注意！安装时选择仅为当前用户安装，否则启动时需要管理员权限。

MacOS整合包（目前只支持M芯片，适合开发者，同样是免安装源码版本，支持一键同步到仓库最新版本，无需等待桌面版打包）

👉 点击下载

⭐注意！你可以在终端使用一键更新(update).sh更新软件，也可以在终端使用一键启动(start).sh启动软件。在使用前，记得给文件加权限！


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

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

👉 点击下载

⭐注意！下载后将dmg文件的app文件拖入/Applications目录下，然后打开终端，执行以下命令并输入root密码，从而移除从网络下载附加的Quarantine属性：


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 key管理：访问http://localhost:3456/token.html

源码部署


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

软件截图

多服务商支持：本地部署引擎(ollama/dify等等)以及云服务商接口均支持

海量工具：内置各种工具(如知识库、联网、智能家居、浏览器控制)，支持异步调用，不阻塞智能体回复

VRM桌宠：支持上传自定义VRM模型，打造专属桌面伴侣

扩展系统：支持安装扩展，和自己创造新的扩展，下图为galgame扩展

酒馆角色卡：支持酒馆角色卡，支持长期记忆

社交平台机器人：支持一键部署到QQ、飞书、telegram、discord

直播机器人：支持一键部署到B站、YouTube、twitch

开发者友好：开放openai API接口、MCP接口，可以将智能体对外转接

扩展

新增了全新的扩展系统，你可以在这里扩展列表查看有哪些插件可用，你也可以直接在party中直接在【开发者】->【扩展】中查看和安装插件。你可以在super-agent-party.github.io 将你自己开发的扩展添加到官方扩展列表中！

硬件要求

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、飞书、discord、telegram，后续会支持更多平台
直播机器人	目前已支持B站、YouTube、twitch，后续会支持更多平台
播报机器人	支持长文播报，多语音播报，数字人口播，超长文本批量转语音（可下载），支持常见电子书epub等格式解析，后续开发分章节转录功能
对话界面	对话界面已支持公式、mermaid绘图、HTML代码绘图等前端渲染功能，图像支持下载和复制。支持胶囊模式和小助手模式，方便将对话界面缩小停靠，配合桌面视觉和截图，无缝融入工作娱乐
角色扮演	支持酒馆角色卡上传、编辑及下载，可为不同角色配置不同语音和形象。支持长期记忆，使用角色卡时，支持多语音，非角色文字支持使用旁白音色，支持表情包
大量原生工具	工具调用支持异步，支持联网、知识库、控制智能家居、控制浏览器、在沙盒中执行代码、控制comfyui绘图、Claude code操作文件系统等
自定义工具接口	已支持MCP、A2A、HTTP请求、任意LLM接口作为主智能体的工具使用，让用户以完全自由的方式定制自己的智能体工具链
对外接口开放	开发者友好，对外开放模拟openAI和MCP的API接口，以及桌宠API接口
扩展系统	你可以在这里扩展列表查看有哪些插件可用，你也可以直接在party中直接在【开发者】->【扩展】中查看和安装插件。你可以在super-agent-party.github.io 将你自己开发的扩展添加到官方扩展列表中！
存储空间	所有的文件资料均存放在用户本地的数据文件夹中，如果使用NAS部署，还可以作为内网的个人图床、文件床使用