super-agent-party

super-agent-party

⭐零门槛的3D桌面伴侣!支持接入QQ/B站直播、RAG、联网、长期记忆、 酒馆角色卡、代码沙盒、表情包、浏览器控制、Dify、 Home Assistant、MCP、A2A、Comfyui等功能!⭐ A 3D desktop companion with zero barriers! Supports integration with QQ/Bilibili live streaming, RAG, web search, long-term memory, sillyTavern Card, code sandbox, meme packs, browser control, Home Assistant, Dify, MCP, A2A, ComfyUI, more!

Stars: 574

Visit
 screenshot

A 3D AI desktop companion with endless possibilities! This repository provides a platform for enhancing the LLM API without code modification, supporting seamless integration of various functionalities such as knowledge bases, real-time networking, multimodal capabilities, automation, and deep thinking control. It offers one-click deployment to multiple terminals, ecological tool interconnection, standardized interface opening, and compatibility across all platforms. Users can deploy the tool on Windows, macOS, Linux, or Docker, and access features like intelligent agent deployment, VRM desktop pets, Tavern character cards, QQ bot deployment, and developer-friendly interfaces. The tool supports multi-service providers, extensive tool integration, and ComfyUI workflows. Hardware requirements are minimal, making it suitable for various deployment scenarios.

README:

image

简体中文 | English

B站 · youtube · 中文文档 · English doc · 网盘下载 · Quick Start

Introduction

🚀 A 3D AI desktop companion with endless possibilities!

  • ✅ Seamless capability enhancement: It is possible to achieve an enterprise-level upgrade of the LLM API without code modification, seamlessly integrating knowledge bases, real-time networking, permanent memory, compatible SillyTavern Character Card, code execution, multimodal capabilities (vision/drawing/audition/speech), Automation capabilities (controlling smart homes, controlling browsers), deep thinking control and research, and other modular functions into the existing model interface, creating a pluggable LLM enhancement platform.

  • ✅ One-click deployment across all channels: It supports the rapid deployment of intelligent agents to multiple types of terminals, and is compatible with scenarios such as classic chat interfaces, QQ official robots, Bilibili live interaction, and VRM virtual desktop pets, ready to use out of the box.

  • ✅ Ecological tool interconnection: It can freely access third-party intelligent entities and workflows as a tool chain (already adapted to systems such as Dify/ComfyUI/MCP/A2A), and achieve cross-platform capability aggregation through the agent-party architecture.

  • ✅ Standardized interface opening: Provide OpenAI API-compatible interfaces and MCP protocol support, making it easy for developers to directly connect to external systems and achieve rapid transfer and secondary development of the agent's capabilities.

  • ✅ Compatible and adaptable across all platforms: It covers the native running environments of Windows/macOS/Linux, supports Docker containerized deployment and web-based cloud services, and meets the needs of multi-scene technology stacks.

Quick Start

Windows Desktop Installation

👉 Click to download

⭐ Note! Choose to install only for the current user during installation, otherwise, administrator privileges will be required to start.

Windows integration package (installation-free source version)

👉 Click to download

⭐Attention! You can double-click 一键更新(update).bat to update the software, or you can double-click 一键启动(start).bat to start the software.

MacOS Desktop Installation

👉 Click to download

⭐Attention! After downloading, drag the app file of the dmg file into the /Applications directory, then open end point, execute the following command and enter the root password to remove the attached Quarantine attribute from the network download:

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

Linux Desktop Installation

We provide two mainstream Linux installation package formats for your convenience in different scenarios.

1. Install using .AppImage

.AppImage is a Linux application format that does not require installation and can be used immediately. Suitable for most Linux distributions.

👉 Click to download

2. Install using .deb package (Suitable for Ubuntu/Debian systems)

👉 Click to download

Docker Deployment (Recommended)

  • Two commands to install this project:

    docker pull ailm32442/super-agent-party:latest
    docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest
  • ⭐Note! ./super-agent-data can be replaced with any local folder, after Docker starts, all data will be cached in this local folder and will not be uploaded anywhere.

  • Plug and play: access http://localhost:3456/

Source Code Deployment

  • Windows:

    git clone https://github.com/heshengtao/super-agent-party.git
    cd super-agent-party
    uv sync
    npm install
    start_with_dev.bat
  • Linux or Mac:

    git clone https://github.com/heshengtao/super-agent-party.git
    cd super-agent-party
    uv sync
    npm install
    chmod +x start_with_dev.sh
    ./start_with_dev.sh

Software Screenshots

Multi-Service Provider Support: Supports both locally deployed engines (e.g., Ollama, Dify) and cloud service provider APIs.

image

Extensive Tool Integration: Built-in various tools (e.g., knowledge base, web search, smart home control, browser automation), supporting asynchronous invocation without blocking agent responses.

image

VRM Desktop Pet: Supports uploading custom VRM models to create a personalized desktop companion.

image

Tavern Character Cards: Supports Tavern character cards with long-term memory capabilities.

image

QQ Bot: Supports one-click deployment to the official QQ bot platform, enabling users to access the agent anytime, anywhere.

image

Developer-Friendly: Provides open OpenAI API and MCP interfaces, allowing the agent to be exposed externally.

image

ComfyUI Integration: Converts ComfyUI workflows into agent tools with load balancing across multiple ComfyUI servers.

image

Hardware requirements

  • CPU: 2 cores or more
  • Memory: 2GB or more

Because all models are optional, you can access the local deployment engine, or you can all use the Cloud as a Service provider interface, so there are few hardware requirements. Test the docker version on the 2-core 2G Cloud as a Service server and it will work fine

Usage

  • Desktop: Click the desktop icon to use immediately.

  • Web or docker: Access http://localhost:3456/ after startup.

  • API call: Developer-friendly, perfectly compatible with OpenAI format, can output in real-time, and does not affect the original API's response speed. No need to modify the calling code:

    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": "What is Super Agent Party?"}
      ]
    )
    print(response.choices[0].message.content)
  • MCP call: After starting, you can invoke the local MCP service by writing the following content in the configuration file:

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

Features

Please refer to the following document for the main functions:

Disclaimer:

This open-source project and its content (hereinafter referred to as the "project") are for reference only and do not imply any explicit or implicit warranties. The project contributors do not assume any responsibility for the completeness, accuracy, reliability, or applicability of the project. Any behavior that relies on the project content shall be at the user's own risk. In any case, the project contributors shall not be liable for any indirect, special, or incidental losses or damages arising from the use of the project content.

License Agreement

This project uses a dual licensing model:

  1. By default, this project follows the GNU Affero General Public License v3.0 (AGPLv3) license agreement
  2. If you need to use this project for closed-source commercial purposes, you must obtain a commercial license from the project administrator

Using this project for closed-source commercial purposes without written authorization is considered a violation of this agreement. The complete text of AGPLv3 can be found in the LICENSE file in the project root directory or at gnu.org/licenses.

Support:

Please star us!

⭐Your support is the driving force for us to move forward!

star

Follow us

octocat octocat
YouTube Video Thumbnail

Join the Community

If you have any questions or issues with the project, you are welcome to join our community.

  1. QQ Group: 931057213
  1. WeChat Group: we_glm (add the assistant's WeChat and join the group)

  2. Discord: Discord link

Star History

Star History Chart

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for super-agent-party

Similar Open Source Tools

For similar tasks

For similar jobs