How heshengtao/super-agent-party works
Super Agent Party is an AI desktop companion combining chat, agent tools, persistent memory, animated characters, messaging bots, and live-stream integrations. The principal user workflow is to send a request through the chat interface, have an agent use tools or background tasks as needed, and receive a result; the README documents these capabilities, but the server and Electron wiring were not excerpted. The graph therefore keeps those connections conservative. It includes the sampled settings, memory, behavior, messaging, livestream, and speech-runtime layers without assuming unshown calls.
Main entry points: server.py API and app server · behavior_engine.py Behavior scheduler · feishu_bot_manager.py Feishu bot · qq_bot_manager.py QQ bot
Components 26
Desktop experience
- Desktop host
main.js - Chat interface
static/js/renderer.js - Avatar interface
static/js/vrm.js
Agents and memory
- API and app server
server.py - Settings and state
py/get_setting.py - Agent tools
py/agent_tool.py - Background tasks
py/task_center.py - Memory scheduler
py/diary_engine.py - Chat memory integration
py/diary_chat_integration.py - Memory system
py/diary_system.py - Behavior scheduler
py/behavior_engine.py - Shortcut commands
py/shortcut_commands.py
Messaging integrations
- Feishu bot
py/feishu_bot_manager.py - QQ bot
py/qq_bot_manager.py - WeChat bot
py/wechat_bot_manager.py - Other IM bots
py/discord_bot_manager.py
Live streaming
- Live-stream routing
py/live_router.py - Bilibili connection
py/blivedm/clients/ws_base.py - Live message dispatch
py/blivedm/handlers.py - Live message models
py/blivedm/models/web.py
Character and speech
- THA character engine
py/tha_engine.py - VTube Studio control
py/vts_manager.py - Speech runtime
py/moss/tts_runtime.py - ONNX speech runtime
py/moss/ort_cpu_runtime.py - Speech normalizer
py/moss/tts_robust_normalizer_single_script.py
Other components
- User
Connections 25
- User → Chat interface: sends requests
README.md - Chat interface → API and app server: submits chat
- API and app server → Agent tools: invokes tools
- API and app server → Background tasks: starts tasks
README.md - API and app server → Chat memory integration: uses chat memory
py/diary_engine.py - Chat memory integration → Memory system: uses memory system
py/diary_chat_integration.py - Memory scheduler → Settings and state: loads settings
py/diary_engine.py - Memory scheduler → Behavior scheduler: dispatches behavior
py/diary_engine.py - Feishu bot → Behavior scheduler: updates behavior
py/feishu_bot_manager.py - QQ bot → Behavior scheduler: uses behavior
- WeChat bot → Behavior scheduler: updates behavior
py/wechat_bot_manager.py - Feishu bot → Shortcut commands: parses commands
py/feishu_bot_manager.py - WeChat bot → Shortcut commands: parses commands
py/wechat_bot_manager.py - QQ bot → Shortcut commands: uses commands
py/qq_bot_manager.py - User → Feishu bot: messages bot
README.md - User → QQ bot: messages bot
README.md - User → WeChat bot: messages bot
README.md - User → Other IM bots: messages bot
README.md - Live-stream routing → Bilibili connection: connects stream
- Bilibili connection → Live message dispatch: dispatches messages
py/blivedm/clients/ws_base.py - Live message dispatch → Live message models: converts messages
py/blivedm/handlers.py - Avatar interface → THA character engine: renders character
README.md - Avatar interface → VTube Studio control: controls model
README.md - Speech runtime → ONNX speech runtime: uses runtime
py/moss/tts_runtime.py - Speech runtime → Speech normalizer: uses normalizer
py/moss/tts_runtime.py