![image](static/source/coveren.png)
####

Trendshift

####
## Введение ### 🚀 **Настольный AI-компаньон с безграничными возможностями!** #### Настольный компаньон: поддерживает кастомные VRM-модели, действия, 3D-сцены и совместим с [live2D-расширениями](https://github.com/heshengtao/sap-live2d) ![image](doc/image/img-2/cover.jpeg) #### Link VTS: управляйте Live2D-моделями в Vtube Studio с поддержкой кастомных действий и контролем выражений лица ![image](doc/image/img-2/vts.jpeg) #### Высокосвободный интерфейс чата: кастомные фоновые изображения, наборы стикеров, персонажи, THA-основанные 2D-аватары и MCP-инструменты персонажей для более погружающего общения ![image](doc/image/img-2/tha4.jpeg) #### Центр задач: ваши AI-агенты могут выполнять любые сложные задачи в фоновом режиме, автоматически управлять вашим компьютером для выполнения работы, с поддержкой MCP и Agent Skills. ![image](doc/image/img-2/task.jpeg) #### Управление компьютером: благодаря компьютерному зрению в сочетании с инструментарием для управления мышью, клавиатурой и терминалом AI-агенты могут выполнять любые задачи на компьютере! На изображении ниже AI играет в Wordle. ![image](doc/image/img-2/vision.jpeg) #### Несколько режимов окон: интерфейс чата поддерживает докинг на рабочем столе в размере телефона и капсулы ![image](doc/image/img-1/windowmode.jpeg) #### Многоролевой групповой чат: поддерживает карточки персонажей Tavern и долговременную память, позволяя общаться с несколькими персонажами одновременно! ![image](doc/image/img-2/group.jpeg) #### Бот для мессенджеров: поддерживает развёртывание в один клик для QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack ![image](doc/image/img-2/im.jpeg) #### Бот для стримов: поддерживает развёртывание в один клик для Bilibili, YouTube, Twitch, а также 360-градусные панорамные трансляции. ![image](doc/image/img-2/yt.jpeg) #### AI-браузер: оснастите ваших AI-агентов собственным браузером с поддержкой автоматического управления ![image](doc/image/img-2/browser.jpeg) #### Система расширений: поддерживает установку и создание новых расширений. На изображении ниже показано расширение galgame. Все расширения можно открывать как в отдельном окне, так и на боковой панели. Вы также можете использовать навык агента [sap-extension-creator](skills/sap-extension-creator) для создания новых SAP-расширений, реализуя начальную загрузку агентной вечеринки! ![image](doc/image/img-2/ext.jpeg) #### Дружелюбность к разработчикам: предоставляет открытые API-интерфейсы OpenAI и MCP, позволяя подключать агентов извне ![image](doc/image/img-2/api.jpeg) ## Быстрый старт ### Если вы CLI-агент CLI-агенту необходимо ознакомиться с документацией в [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md). Пожалуйста, используйте этот документ, чтобы помочь пользователям установить данное программное обеспечение! ### Если вы человек, использующий CLI-агента Отправьте эту ссылку вашему AI, и AI проведёт вас через процесс установки! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### Windows portable пакет (Рекомендуется! Версия без установки, поддержка одно-click синхронизации с последней версией репозитория, не нужно ждать сборки десктопной версии) 👉 [Скачать](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐ Примечание! Вы можете дважды кликнуть `一键更新(update).bat` для обновления или `一键启动(start).bat` для запуска. Операционная система должна быть **Windows 10/11, Windows Server 2025** или новее! ### Windows Desktop Installation 👉 [Скачать](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐ Примечание! При установке выберите установку только для текущего пользователя, иначе для запуска потребуются права администратора. Операционная система должна быть **Windows 10/11, Windows Server 2025** или новее! ### MacOS Integrated Package (В настоящее время поддерживает только M-чипы, версия без установки, поддержка одно-click синхронизации с последней версией репозитория, не нужно ждать сборки десктопной версии) > **Подходит для разработчиков/продвинутых пользователей**: версия без установки, поддержка одно-click синхронизации с последней версией репозитория, не нужно ждать сборки десктопной версии. 👉 [Скачать](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 Инструкция по использованию **1. Снятие карантина сетевой загрузки (Важно)** После загрузки и распаковки откройте Терминал, введите следующую команду (обратите внимание на пробел в конце), затем перетащите **распакованную папку** в окно Терминала и нажмите Enter: ```shell sudo xattr -rd com.apple.quarantine ``` *(Примечание: параметр `-rd` рекурсивно удаляет атрибуты карантина для всех компонентов внутри папки; в противном случае окружение Python может работать некорректно.)* **2. Предоставление прав на выполнение скриптов** В Терминале перейдите в папку и выполните: ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. Запуск** - **Первое использование/Обновление:** рекомендуется сначала выполнить `./一键更新(update).sh`, чтобы синхронизировать зависимости до последней версии. - **Ежедневный запуск:** непосредственно выполните `./一键启动(start).sh`. ### Установка MacOS Desktop (В настоящее время поддерживаются только M-чипы) 👉 [Скачать](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐ Внимание! После загрузки перетащите приложение из dmg-файла в директорию `/Applications`, затем откройте Терминал, выполните следующую команду и введите root-пароль для снятия атрибута карантина: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Установка Linux Desktop `.AppImage` — это формат приложений Linux, не требующий установки и готовый к использованию сразу. Подходит для большинства дистрибутивов Linux. 👉 [Linux-AppImage-X86_64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-x86_64.AppImage) 👉 [Linux-AppImage-Arm64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-arm64.AppImage) ### Docker Deployment (Эту версию десктопного питомца можно просматривать только через браузер) ```shell 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 Deployment (Эту версию десктопного питомца можно просматривать только через браузер, также будет запущен дополнительный контейнер шлюза для управления входом) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` ⭐ Примечание! Имя пользователя по умолчанию — `root`, пароль по умолчанию — `pass`. Пожалуйста, измените пароль после первого входа. **Готово к использованию:** Откройте http://localhost:3456/ **Управление API-ключами:** Откройте http://localhost:3456/token.html ### Lite клиент, превращающий Docker в десктопное приложение 👉 [SAP-lite-Windows-exe](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-Setup-0.1.2.exe) 👉 [SAP-lite-MacOS-dmg](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-0.1.2-Mac.dmg) ### Деплой из исходного кода ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## Расширения Добавлена совершенно новая система расширений. Вы можете просмотреть доступные плагины в [списке плагинов](https://super-agent-party.github.io/plugins.html) или напрямую просмотреть и установить их в вечеринке через 【Разработчик】→【Расширения】. Вы также можете добавить свои собственные расширения в официальный список плагинов на [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io)! ### Существующие расширения | Название | Автор | Описание | URL репозитория | |-----------------------|-------------------|--------------------------------------------------------------------|--------------------------------------------------| | Super Agent Party Example | heshengtao | Пример плагина для Super Agent Party, демонстрирующий архитектуру и возможности плагинов. | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | Пример чат-интерфейса с окружением NodeJS | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | Плагин, добавляющий функциональность веб-просмотра для Super Agent Party. | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | Интерактивный плагин приключенческой истории, генерирующий сюжет и варианты с помощью AI. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | Расширение Live 2D | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | AI-редактор | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | Расширение AI galgame | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | Расширение AI таролога | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | Расширение AI таблиц | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | Расширение AI drawio | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | Расширение редактора AI mermaid | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | Расширение AI RSS-ридера для Super Agent Party | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | Одно-click публикация Super Agent Party в интернет | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | IDE-расширение для Super Agent Party | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | CLI-расширение для Super Agent Party | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | Подключите super agent party к LX Music API, позвольте AI-компаньону управлять воспроизведением музыки! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | AI PPT расширение для Super Agent Party | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | Расширение персонажа Звёздный маг — одно-click установка карточки персонажа, THA-модели, стикеров и фона | https://github.com/heshengtao/sap-lyra-extension | ## Системные требования - CPU: 2 ядра или более - Память: 2 ГБ или более **Поскольку все модели являются опциональными, вы можете использовать локальный движок развёртывания или интерфейсы облачных провайдеров, поэтому аппаратные требования минимальны. Docker-версия была протестирована на 2-ядерном 2-гигабайтном облачном сервере и работает отлично.** ## Использование - Десктоп: нажмите на иконку на рабочем столе для мгновенного использования. - Веб или Docker: после запуска перейдите по адресу http://localhost:3456/. - API-вызов: дружелюбно к разработчикам, полностью совместимо с форматом OpenAI, поддерживает вывод в реальном времени, не влияя на скорость ответа оригинального API. Нет необходимости изменять код вызова: ```python 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-сервис, записав следующее содержимое в файл конфигурации: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp", } } } ``` - Команды быстрого доступа: в поле ввода чата или в любой подключённой IM-платформе (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk) введите указанные ниже команды для быстрого управления ассистентом. Вы можете включать/отключать их и просматривать полный список в **Настройки системы → Команды быстрого доступа**. | Команда | Псевдонимы | Область | Описание | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | Чат + IM | Показать список всех доступных команд быстрого доступа | | `/new` | `/reset` `/重启` `/新建` `/restart` | Чат + IM | Очистить текущий разговор и начать новый | | `/stop` | `/停止` | Чат + IM | Остановить текущую генерацию ответа | | `/retry` | `/重试` | Только чат | Повторно сгенерировать последний ответ | | `/model [provider:model]` | `/模型` | Чат + IM | Показать или сменить модель (в IM только отображение) | | `/personality [name]` | `/角色` `/persona` | Чат + IM | Показать или сменить личность | | `/skills` | `/技能` | Чат + IM | Просмотреть список доступных навыков | | `/id` | - | Только IM | Показать ChatID текущей сессии/канала | | `/sub` | `/订阅` | Только IM | Добавить текущую сессию в список проактивных сообщений | | `/unsub` | `/取消订阅` | Только IM | Удалить текущую сессию из списка проактивных сообщений | | `/plan` * | `/计划` | Чат + IM | Переключиться в режим планирования (только чтение) | | `/read` * | `/只读` | Чат + IM | Переключиться в режим только чтения (подтверждать каждое действие) | | `/edit` * | `/编辑` | Чат + IM | Переключиться в режим принятия правок | | `/yolo` * | - | Чат + IM | Переключиться в режим Yolo (полная автономия) | | `/cowork` * | `/协作` | Чат + IM | Переключиться в режим совместной работы (взаимодействие суб-агентов) | | `/goal` * | `/目标` | Чат + IM | Переключиться в режим цели (автономный цикл) | | `/` * | - | Чат + IM | Внедрить указанный навык | | `#` * | - | Чат + IM | Сохранить память рабочего пространства | | `@` * | - | Только чат | Сослаться на файл в рабочем пространстве | > `*` Требуется включение управления через CLI компьютера; внедрение навыков, `#` память и `@` ссылки на файлы также требуют настроенного рабочего пространства. ## Возможности Пожалуйста, обратитесь к следующей документации по основным функциям: - 👉 [Китайская документация](https://gcnij7egmcww.feishu.cn/wiki/DPRKwdetCiYBhPkPpXWcugujnRc) - 👉 [Английская документация](https://temporal-lantern-7e8.notion.site/super-agent-party-211b2b2cb6f180c899d1c27a98c4965d) | Возможность | Подробности | | --- | --- | | Поддерживаемые провайдеры моделей | Поддерживает интерфейсы распространённых локальных движков и облачных провайдеров, таких как: openai/ollama/dify и др. | | Интеграция мультимодальных моделей | Интегрирует различные типы моделей, включая ролевые игры, рассуждения, зрение, генерацию изображений, распознавание речи и синтез речи для совместного использования. | | VRM-робот-питомец на рабочем столе | Высокая степень настройки с поддержкой кастомных аватаров, кастомных анимаций, голосового взаимодействия и прерывания диалога. Может транслироваться прозрачно в программы для записи экрана, такие как OBS, и поддерживает двунаправленный протокол VMC! | | THA-питомец на рабочем столе | Разговорная голова в стиле Live2D с анимацией на основе аудио blendshapes, синтез речи в реальном времени и прерываемый диалог, прозрачное наложение, совместимое с OBS! | | Link VTS | Управляйте Live2D-моделями в Vtube Studio с синхронизацией выражений в реальном времени, кастомными анимациями и голосовым взаимодействием с синхронизацией губ! | | Боты для мессенджеров | В настоящее время поддерживаются QQ, WeChat, Feishu, Telegram, Discord, Slack. В будущем будут добавлены новые платформы | | Боты для стримов | В настоящее время поддерживаются Bilibili, YouTube, Twitch. В будущем будут добавлены новые платформы | | Бот-диктор | Поддерживает озвучивание длинных текстов, многоголосое озвучивание, цифровое видео с озвучиванием, пакетное преобразование сверхдлинных текстов в речь (с возможностью загрузки) и парсинг распространённых форматов электронных книг, таких как EPUB. Поглавное преобразование будет разработано позже. | | Интерфейс чата | Интерфейс чата поддерживает функции фронтенд-рендеринга, такие как A2UI, математические формулы, диаграммы mermaid и графику HTML-кода. Изображения можно скачивать или копировать. Поддерживает режим капсулы и режим ассистента, позволяя легко сворачивать и стыковать интерфейс разговора. В сочетании с компьютерным зрением и скриншотами бесшовно встраивается в работу и развлечения | | Ролевая игра | Поддерживает загрузку, редактирование и скачивание карточек персонажей Tavern. Позволяет настраивать разные голоса и аватары для разных персонажей. Обладает долговременной памятью, поддержкой нескольких голосов при использовании карточек персонажей, голосом рассказчика для текста не от лица персонажа, а также поддержкой эмодзи и мемов. | | Обширные встроенные инструменты | Вызов инструментов поддерживает асинхронное выполнение, включая веб-поиск, доступ к базам знаний, управление умным домом, управление браузером, выполнение кода в песочнице, управление ComfyUI для генерации изображений и Claude code для операций с файловой системой. | | Пользовательские интерфейсы инструментов | Поддерживает MCP, Skills, A2A, HTTP-запросы и любые LLM-интерфейсы в качестве инструментов для главного агента, позволяя пользователям свободно настраивать инструментарий своего агента. | | Открытые внешние API | Дружелюбно к разработчикам с открытыми API, имитирующими OpenAI и MCP, а также API для настольных питомцев. | | Система расширений | Вы можете просмотреть доступные плагины в [списке расширений](https://super-agent-party.github.io/plugins.html). Вы также можете просматривать и устанавливать плагины непосредственно в вечеринке, перейдя в 【Разработчик】 → 【Расширения】. Вы можете добавить свои собственные расширения в официальный список на [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io)! | ## Отказ от ответственности: Данный проект с открытым исходным кодом и его содержимое (далее «Проект») предоставляются исключительно для ознакомления и не подразумевают каких-либо явных или подразумеваемых гарантий. Участники проекта не несут ответственности за полноту, точность, надёжность или пригодность проекта. Любые действия, основанные на содержании проекта, осуществляются пользователем на свой страх и риск. Ни при каких обстоятельствах участники проекта не несут ответственности за любые косвенные, особые или случайные убытки или ущерб, возникшие в результате использования содержания проекта. ## Особые примечания 1. Некоторые функции данного проекта с открытым исходным кодом (такие как синтез речи Edge TTS и др.) полагаются на публичные интерфейсы или экспериментальные функции, предоставляемые сторонними сервисами. Эти функции могут стать недоступными в любое время из-за изменений в политике третьих сторон. Разработчик не несёт ответственности за их стабильность, легальность или непрерывность. Используя данный проект, пользователь считается ознакомленным и согласившимся с соответствующими рисками. Разработчик не рекомендует и не поощряет использование этих функций в коммерческих или крупномасштабных сценариях развёртывания. 2. QQ-бот использует официальный интерфейс QQ-бота. Пожалуйста, соблюдайте [Правила использования AIGC QQ Bot](https://q.qq.com/#/news/detail?id=1376238e8e2fbbc036676bb09d2f37da). 3. Функция управления браузером, предоставляемая в этом проекте, представляет собой интерфейс ассистивного просмотра на основе больших языковых моделей (LLM). Она предназначена для помощи людям с нарушениями зрения, пожилым людям или людям с ограниченными возможностями передвижения в более удобном управлении браузером с помощью команд на естественном языке, используя технологию AI визуального распознавания. Она не предназначена для автоматического сбора данных или взлома. Проект использует архитектуру «LLM визуальное рассуждение → одношаговая операция». Интерфейс ассистивного просмотра имеет следующие характеристики: a. Без высокой частоты одновременных запросов: из-за зависимости от скорости рассуждения LLM (3–5 секунд на шаг) и встроенных рандомизированных алгоритмов задержки, имитирующих человеческое поведение, частота операций инструмента строго ниже максимальной ручной скорости обычного пользователя. b. Без нагрузки на сервер: этот инструмент не поддерживает многопоточные одновременные запросы, пакетный сбор данных или DDoS-атаки. С точки зрения сервера его поведение неотличимо от поведения обычного пользователя и не создаёт дополнительной нагрузки на сервер целевого веб-сайта. 4. Не используйте этот проект на страницах банков, платёжных шлюзов или страницах с высококонфиденциальной информацией. Разработчик не несёт ответственности за утечку конфиденциальности, вызванную неправильными действиями пользователя. Запрещённые действия включают массовый сбор данных, обход механизмов безопасности, вмешательство в сеть и нарушение законов и нормативных актов. 5. Данный проект является независимо разработанным инструментом с открытым исходным кодом. При использовании данного программного обеспечения для доступа к сторонним API-сервисам пользователь несёт ответственность за соблюдение соответствующих Условий предоставления услуг поставщиков услуг. 6. Любое содержимое, созданное данным программным обеспечением через сторонние большие языковые модели, является ответственностью поставщиков моделей и действий пользователя в отношении точности, полноты и соответствия требованиям. Автор данного программного обеспечения не несёт юридической ответственности за такое содержимое. ## Лицензионное соглашение Этот проект использует модель двойного лицензирования: 1. По умолчанию данный проект следует лицензионному соглашению **GNU Affero General Public License v3.0 (AGPLv3)** 2. Если вам необходимо использовать этот проект в закрытых коммерческих целях, вы должны получить коммерческую лицензию от администратора проекта. Деловое сотрудничество: hst97@qq.com Использование данного проекта в закрытых коммерческих целях без письменного разрешения считается нарушением данного соглашения. Полный текст AGPLv3 можно найти в файле LICENSE в корневой директории проекта или на [gnu.org/licenses](https://www.gnu.org/licenses/agpl-3.0.html). ### Лицензии сторонних компонентов Данный проект может включать или зависеть от определённых сторонних библиотек или компонентов, лицензии которых могут отличаться от лицензии основного проекта. Для соблюдения соответствующих лицензионных требований вы можете найти информацию о лицензиях этих сторонних компонентов в папке [LICENSE-third-party](./LICENSE-third-party) в корневой директории проекта или в исходном коде соответствующего компонента. Мы выражаем благодарность всем участникам сторонних библиотек и компонентов и обязуемся уважать условия их лицензий. ## Поддержка: ### Поставьте нам звезду! ⭐ Ваша поддержка — движущая сила нашего движения вперёд!
star
### Чаевые приветствуются!
[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/agentparty) [![爱发电](https://img.shields.io/badge/爱发电-支持我们-946ce6?style=for-the-badge&logo=affine&logoColor=white)](https://afdian.com/a/agentparty)
### Следите за нами
octocat octocat
YouTube Video Thumbnail
### Присоединяйтесь к сообществу Если у вас есть вопросы или проблемы с проектом, приглашаем присоединиться к нашему сообществу. 1. QQ группа: `931057213` (1 группа заполнена) `902882342` (2 группа)
2. Discord: [Ссылка на Discord](https://discord.gg/f2dsAKKr2V) ## Участники ## История звезд [![Star History Chart](https://api.star-history.com/svg?repos=heshengtao/super-agent-party&type=Date)](https://www.star-history.com/#heshengtao/super-agent-party&Date)