Repolode
Submit
heshengtao

heshengtao/super-agent-party

A self-hosted, all-in-one AI companion combining a desktop VRM/Live2D avatar, multi-platform chat bots, live streaming bots, and an agent with tools, MCP and skills.

Open-source alternative to:Character.AI

View on GitHubWebsite
Stars
2,749
Forks
295
Open issues
15
Last commit
4 days ago

What is it?

Super Agent Party is a self-hosted AI companion application that combines a desktop pet with an agent platform. It can run as a Windows, macOS or Linux desktop app, or be deployed with Docker and used from a browser. The chat interface supports tavern character cards, long-term memory, multi-character group chat, and VRM or THA avatars that can be streamed to OBS.

On the agent side, it provides a task center where agents run in the background, computer control through desktop vision and mouse/keyboard/terminal tools, an built-in AI browser, and tool calling for web search, smart home control, ComfyUI image generation and sandboxed code execution. Tools can come from MCP servers, Agent Skills, A2A, HTTP requests or any LLM interface. An extension system lets users install or write extensions that open in a separate window or a sidebar.

The project also exposes an OpenAI-compatible API and an MCP endpoint, so external programs can call the agent. It can be connected to QQ, WeChat, Feishu, DingTalk, Telegram, Discord and Slack as a messaging bot, and to Bilibili, YouTube and Twitch for live streaming. Model providers include OpenAI, Ollama and Dify, among others.

Key features

  • 01Desktop VRM and Live2D-style avatars that can be streamed to OBS
  • 02Multi-platform bots for QQ, WeChat, Feishu, DingTalk, Telegram, Discord and Slack
  • 03Live streaming bots for Bilibili, YouTube and Twitch
  • 04Background task center with computer control and an built-in AI browser
  • 05OpenAI-compatible API and MCP endpoint for external integration
  • 06Extension system with installable plugins and a developer mode

Use cases

  • Running a personal desktop AI companion with a custom avatar and voice
  • Deploying a customer or community chatbot across IM platforms
  • Hosting an AI VTuber or live stream host on Bilibili, YouTube or Twitch
  • Self-hosting a multi-model agent that exposes an OpenAI-style API to other tools

Quick start

  1. 1

    Pull the Docker image

    docker pull ailm32442/super-agent-party:latest
  2. 2

    Run the container

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

    Open the app in your browser at localhost:3456

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified source code when distributed or served over a network.
  • The Docker deployment can only be viewed through a browser, so the desktop pet is not available there.
  • The macOS integrated package currently supports only Apple M chips.

Topics

#ai-companion#agent#mcp#vtuber#chatbot#live-streaming#self-hosted#desktop-pet#agent-skills#ai-vtuber

FAQ

What is super-agent-party?
A self-hosted, all-in-one AI companion combining a desktop VRM/Live2D avatar, multi-platform chat bots, live streaming bots, and an agent with tools, MCP and skills. Super Agent Party is a self-hosted AI companion application that combines a desktop pet with an agent platform. It can run as a Windows, macOS or Linux desktop app, or be deployed with Docker and used from a browser. The chat interface supports tavern character cards, long-term memory, multi-character group chat, and VRM or THA avatars that can be streamed to OBS.
Is super-agent-party free to use? What license does it have?
super-agent-party is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is super-agent-party still maintained?
Actively maintained. The last commit to super-agent-party was on Oct 18, 2026.
What can I use super-agent-party for?
Running a personal desktop AI companion with a custom avatar and voice Deploying a customer or community chatbot across IM platforms Hosting an AI VTuber or live stream host on Bilibili, YouTube or Twitch Self-hosting a multi-model agent that exposes an OpenAI-style API to other tools
How do I install super-agent-party?
Pull the Docker image: docker pull ailm32442/super-agent-party:latest Run the container: docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest Open the app in your browser at localhost:3456
Where can I get super-agent-party?
The source code and installation instructions are on GitHub: https://github.com/heshengtao/super-agent-party

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects