heshengtao/super-agent-party

CLI Agent needs to check the documentation at README_AGENT.md. Please refer to this document to guide users through installing this software!

Send this link to your AI, and the AI will guide you through installing this software!

curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md

👉 Click to download

👉 中国用户点击下载

⭐ Note! You can double-click 一键更新(update).bat to update the software, or you can double-click 一键启动(start).bat to start the software.The operating system must be Windows 10/11, Windows Server 2025, or a later version!

👉 Click to download

👉 中国用户点击下载

⭐ Note! Choose to install only for the current user during installation, otherwise, administrator privileges will be required to start.The operating system must be Windows 10/11, Windows Server 2025, or a later version!

Suitable for developers/advanced users: No-install source code version, supports one-click sync to the latest repository version, no need to wait for desktop version packaging.

👉 International users click to download

👉 中国用户点击下载

1. Remove Network Download Quarantine (Important) After downloading and extracting, open Terminal, enter the following command (note there is a space at the end), then drag the extracted folder into the Terminal window and press Enter:

sudo xattr -rd com.apple.quarantine 

(Note: The -rd parameter recursively removes the quarantine attributes for all components within the folder; otherwise, the Python environment may not function properly.)

2. Grant Script Execution Permissions Navigate to the folder in Terminal and execute:

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

3. Run the Software

• First use/Update: It is recommended to first execute ./一键更新(update).sh to ensure dependencies are synced to the latest.
• Daily startup: Directly execute ./一键启动(start).sh.

👉 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

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

👉 Linux-AppImage-X86_64

👉 Linux-AppImage-Arm64

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

docker pull crpi-9mgnqijkd7wc42x2.cn-shenzhen.personal.cr.aliyuncs.com/ailm32442/super-agent-party:latest
docker run -d -p 3456:3456 -v ./super-agent-data:/app/data crpi-9mgnqijkd7wc42x2.cn-shenzhen.personal.cr.aliyuncs.com/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.

Out of the box: Visit http://localhost:3456/

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

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

⭐ Note! The default username is root, and the default password is pass. Please change the password after the first login.

Out of the box: Visit http://localhost:3456/

API key management: Visit http://localhost:3456/token.html

👉 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

Added a brand-new extension system. You can check available plugins at plugins list, or directly view and install them in the party under 【Developer】->【Extensions】. You can also add your own developed extensions to the official plugin list at super-agent-party.github.io!

• 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

• 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",
      }
    }
  }

• Shortcut commands: In the chat box or any connected IM platform (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk), type the commands below to quickly control the assistant. You can toggle them and view the full list in System Settings → Shortcut Commands.

  Command	Aliases	Scope	Description
  /help	/帮助 /?	Chat + IM	List all available shortcut commands
  /new	/reset /重启 /新建 /restart	Chat + IM	Clear the current conversation and start fresh
  /stop	/停止	Chat + IM	Stop the response currently being generated
  /retry	/重试	Chat only	Regenerate the last reply
  /model [provider:model]	/模型	Chat + IM	Show or switch the model (IM shows only)
  /personality [name]	/角色 /persona	Chat + IM	Show or switch the personality
  /skills	/技能	Chat + IM	Browse the list of available skills
  /id	-	IM only	Show the current session/channel ChatID
  /sub	/订阅	IM only	Add the current session to the proactive message list
  /unsub	/取消订阅	IM only	Remove the current session from the proactive message list
  /plan *	/计划	Chat + IM	Switch to plan mode (read-only)
  /read *	/只读	Chat + IM	Switch to read-only mode (confirm each action)
  /edit *	/编辑	Chat + IM	Switch to accept-edits mode
  /yolo *	-	Chat + IM	Switch to Yolo mode (full autonomy)
  /cowork *	/协作	Chat + IM	Switch to cowork mode (sub-agent collaboration)
  /goal *	/目标	Chat + IM	Switch to goal mode (autonomous loop)
  /<skill-name> *	-	Chat + IM	Inject the specified skill
  #<text> *	-	Chat + IM	Save workspace memory
  @<path> *	-	Chat only	Reference a workspace file

  * Requires computer CLI control to be enabled; skill injection, # memory and @ file reference also require a configured workspace.

Please refer to the following document for the main functions:

• 👉 Chinese document
• 👉 English document

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.

1. Certain features of this open-source project (such as Edge TTS voice synthesis, etc.) rely on public interfaces or experimental functionalities provided by third-party services. These features may become unavailable at any time due to changes in third-party policies. The developer assumes no responsibility for their stability, legality, or continuity.By using this project, users are deemed to have understood and agreed to assume the associated risks. The developer does not recommend or encourage the use of these functions for commercial or large-scale deployment scenarios.

2. The QQ bot utilizes the official QQ bot interface. Please comply with the AIGC QQ Bot Usage Guidelines.

3. The browser control functionality provided in this project is an accessibility-assisted browsing interface based on large language models (LLMs). It is designed to help visually impaired individuals, the elderly, or those with mobility challenges operate browsers more conveniently through natural language commands, using AI visual recognition technology. It is not intended for automated crawling or hacking purposes. The project adopts a technical architecture of "LLM visual reasoning → single-step operation." The accessibility-assisted browsing interface has the following characteristics:
   a. Non-high-frequency concurrency: Due to reliance on LLM reasoning speed (3–5 seconds per step) and built-in randomized human-like delay algorithms, the tool's operation frequency is strictly lower than the maximum manual speed of a typical human user.
   b. No server pressure: This tool does not support multi-threaded concurrency, batch data scraping, or DDoS attacks. From the server's perspective, its behavior is indistinguishable from that of a regular human user and will not impose additional load on the target website's server.

4. Do not use this project on banking, payment gateway, or highly confidential information pages. The developer is not responsible for privacy breaches caused by improper user operations. Prohibited behaviors include large-scale data scraping, bypassing security mechanisms, network interference, and violations of laws and regulations.

5. This project is an independently developed open-source tool. When users utilize this software to access third-party API services, they are responsible for complying with the relevant service providers' Terms of Service.

6. Any content generated by this software through third-party large models is the responsibility of the model providers and user actions in terms of accuracy, completeness, and compliance. The author of this software assumes no legal liability for such content.

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. Business cooperation: hst97@qq.com

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.

This project may include or depend on certain third-party libraries or components, whose licenses may differ from the main project's license. To comply with the relevant license requirements, you can find the license information for these third-party components in the LICENSE-third-party folder located in the project's root directory, or within the corresponding component's source code.

We extend our gratitude to all contributors of the third-party libraries and components and are committed to respecting their license terms.

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

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

1. QQ Group: 931057213（1群已满） 902882342（2群）

1. Discord: Discord link