
#### #### ## Introducción ### 🚀 **¡Un compañero de escritorio con IA con infinitas posibilidades!** #### Compañero de escritorio: Soporta modelos VRM personalizados, acciones, escenas 3D y es compatible con [extensiones live2D](https://github.com/heshengtao/sap-live2d)  #### Link VTS: Controla modelos Live2D en Vtube Studio, con soporte para acciones personalizadas y control de expresiones  #### Interfaz de chat de alta libertad: fondos de pantalla personalizados, paquetes de emojis, personajes, avatares 2D basados en THA y herramientas MCP de personaje para una conversación más inmersiva  #### Centro de tareas: Permite que tus agentes de IA realicen cualquier tarea avanzada en segundo plano, controlando automáticamente tu computadora para completar el trabajo, con soporte para MCP y Agent Skills.  #### Control de computadora: A través de la visión del escritorio combinada con un conjunto de herramientas para controlar el ratón, el teclado y la terminal, los agentes de IA pueden realizar cualquier tarea en una computadora. La imagen de abajo muestra a una IA jugando Wordle.  #### Múltiples modos de ventana: La interfaz de chat admite acoplamiento en tamaño de teléfono y tamaño de cápsula en el escritorio  #### Chat grupal con múltiples roles: Compatible con tarjetas de personaje tavern y memoria a largo plazo, ¡permitiéndote chatear con múltiples personajes simultáneamente!  #### Bot de mensajería instantánea: Soporta despliegue con un clic en QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack  #### Bot de transmisión en vivo: Soporta despliegue con un clic en Bilibili, YouTube, Twitch y permite transmisión en vivo panorámica de 360 grados.  #### Navegador IA: Equipa a tus agentes de IA con su propio navegador, compatible con control automático  #### Sistema de extensiones: Soporta la instalación y creación de nuevas extensiones. La imagen de abajo muestra una extensión de galgame. Todas las extensiones se pueden abrir en una ventana independiente o en una barra lateral. Incluso puedes usar la habilidad de agente [sap-extension-creator](skills/sap-extension-creator) para crear nuevas extensiones SAP, ¡logrando el bootstrap de la agent party!  #### Amigable para desarrolladores: Ofrece interfaces de API OpenAI y MCP abiertas, permitiendo que los agentes se conecten externamente  ## Inicio rápido ### Si eres un agente CLI El agente CLI debe consultar la documentación en [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md). ¡Consulta este documento para guiar a los usuarios en la instalación de este software! ### Si eres un humano que usa un agente CLI ¡Envía este enlace a tu IA y la IA te guiará en la instalación de este software! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### Paquete portátil para Windows (¡Recomendado! Versión de código fuente sin instalación, soporta sincronización con un clic a la última versión del repositorio, sin necesidad de esperar al empaquetado de la versión de escritorio) 👉 [Descargar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐ ¡Nota! Puedes hacer doble clic en `一键更新(update).bat` para actualizar el software, o hacer doble clic en `一键启动(start).bat` para iniciarlo. El sistema operativo debe ser **Windows 10/11, Windows Server 2025** o una versión posterior. ### Instalación de escritorio para Windows 👉 [Descargar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐ ¡Nota! Elige instalar solo para el usuario actual durante la instalación; de lo contrario, se requerirán privilegios de administrador para iniciar. El sistema operativo debe ser **Windows 10/11, Windows Server 2025** o una versión posterior. ### Paquete integrado para MacOS (Actualmente solo compatible con chips M, versión de código fuente sin instalación, soporta sincronización con un clic a la última versión del repositorio, sin necesidad de esperar al empaquetado de la versión de escritorio) > **Adecuado para desarrolladores/usuarios avanzados**: Versión de código fuente sin instalación, soporta sincronización con un clic a la última versión del repositorio, sin necesidad de esperar al empaquetado de la versión de escritorio. 👉 [Descargar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 Pasos de uso **1. Eliminar la cuarentena de descarga de red (Importante)** Después de descargar y extraer, abre la Terminal, ingresa el siguiente comando (nota que hay un espacio al final), luego arrastra la **carpeta extraída** a la ventana de Terminal y presiona Enter: ```shell sudo xattr -rd com.apple.quarantine ``` *(Nota: El parámetro `-rd` elimina recursivamente los atributos de cuarentena de todos los componentes dentro de la carpeta; de lo contrario, el entorno Python podría no funcionar correctamente).* **2. Otorgar permisos de ejecución de scripts** Navega a la carpeta en la Terminal y ejecuta: ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. Ejecutar el software** - **Primer uso/Actualización:** Se recomienda ejecutar primero `./一键更新(update).sh` para asegurar que las dependencias estén sincronizadas con la última versión. - **Inicio diario:** Ejecuta directamente `./一键启动(start).sh`. ### Instalación de escritorio para macOS (Actualmente solo compatible con chips M) 👉 [Descargar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐ ¡Atención! Después de descargar, arrastra el archivo de aplicación del dmg al directorio `/Applications`, luego abre la terminal, ejecuta el siguiente comando e ingresa la contraseña de root para eliminar el atributo de cuarentena de la descarga de red: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Instalación de escritorio para Linux `.AppImage` es un formato de aplicación de Linux que no requiere instalación y se puede usar inmediatamente. Adecuado para la mayoría de las distribuciones de 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) ### Despliegue con Docker (Esta versión de la mascota de escritorio solo se puede ver a través del navegador) ```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 ``` ⭐ ¡Nota! `./super-agent-data` se puede reemplazar con cualquier carpeta local. Después de iniciar Docker, todos los datos se almacenarán en esta carpeta local y no se cargarán en ningún otro lugar. **Listo para usar:** Visita http://localhost:3456/ --- ### Despliegue con Docker Compose (Esta versión de la mascota de escritorio solo se puede ver a través del navegador, y se iniciará un contenedor de puerta de enlace adicional para la gestión de inicio de sesión) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` ⭐ ¡Nota! El nombre de usuario predeterminado es `root` y la contraseña predeterminada es `pass`. Cambia la contraseña después del primer inicio de sesión. **Listo para usar:** Visita http://localhost:3456/ **Gestión de claves API:** Visita http://localhost:3456/token.html ### Cliente ligero para tu versión de Docker, convirtiendo Docker en una aplicación de escritorio 👉 [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) ### Despliegue desde código fuente ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## Extensiones Se ha añadido un nuevo sistema de extensiones. Puedes consultar los plugins disponibles en la [lista de plugins](https://super-agent-party.github.io/plugins.html), o verlos e instalarlos directamente en la party en 【Desarrollador】→【Extensiones】. ¡También puedes añadir tus propias extensiones a la lista oficial de plugins en [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io)! ### Extensiones existentes | Nombre | Autor | Descripción | URL del repositorio | |-------------------------|-------------------|--------------------------------------------------------------------|-------------------------------------------------------| | Super Agent Party Example | heshengtao | Plugin de ejemplo para Super Agent Party, que demuestra la arquitectura y capacidades del plugin. | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | Ejemplo de frontend de chat con entorno NodeJS | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | Plugin que permite la funcionalidad de vista previa web para Super Agent Party. | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | Plugin interactivo de aventuras narrativas que genera contenido y opciones de historia usando IA. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | Extensión Live 2D | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | Editor de IA | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | Extensión de galgame con IA | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | Extensión de lector de tarot con IA | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | Extensión de hoja de cálculo con IA | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | Extensión de drawio con IA | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | Extensión de editor mermaid con IA | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | Extensión de lector RSS con IA para Super Agent Party | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | Expone Super Agent Party a internet público con un clic | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | Extensión IDE para Super Agent Party | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | Extensión CLI para Super Agent Party | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | Conecta super agent party a la API de LX Music, ¡permite que tu compañero IA controle la reproducción de música! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | Extensión de PPT con IA para Super Agent Party | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | Extensión de personaje maga estelar — instala con un clic la tarjeta de personaje, modelo THA, stickers y fondo | https://github.com/heshengtao/sap-lyra-extension | ## Requisitos del sistema - CPU: 2 núcleos o más - Memoria: 2GB o más **Debido a que todos los modelos son opcionales, puedes acceder al motor de despliegue local, o puedes usar exclusivamente interfaces de proveedores de servicios en la nube, por lo que los requisitos de hardware son mínimos. La versión Docker se probó en un servidor en la nube de 2 núcleos y 2 GB y funciona sin problemas.** ## Uso - Escritorio: Haz clic en el icono del escritorio para usarlo de inmediato. - Web o Docker: Accede a http://localhost:3456/ después de iniciar. - Llamada a la API: Amigable para desarrolladores, totalmente compatible con el formato OpenAI, puede generar en tiempo real y no afecta la velocidad de respuesta de la API original. No es necesario modificar el código de llamada: ```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": "¿Qué es Super Agent Party?"} ] ) print(response.choices[0].message.content) ``` - Llamada MCP: Después de iniciar, puedes invocar el servicio MCP local escribiendo el siguiente contenido en el archivo de configuración: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp", } } } ``` - Comandos rápidos: En la caja de chat o en cualquier plataforma de mensajería conectada (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk), escribe los siguientes comandos para controlar rápidamente al asistente. Puedes activarlos/desactivarlos y ver la lista completa en **Configuración del sistema → Comandos rápidos**. | Comando | Alias | Ámbito | Descripción | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | Chat + IM | Lista todos los comandos rápidos disponibles | | `/new` | `/reset` `/重启` `/新建` `/restart` | Chat + IM | Borra la conversación actual y comienza de nuevo | | `/stop` | `/停止` | Chat + IM | Detiene la respuesta que se está generando | | `/retry` | `/重试` | Solo chat | Regenera la última respuesta | | `/model [provider:model]` | `/模型` | Chat + IM | Muestra o cambia el modelo (IM solo muestra) | | `/personality [name]` | `/角色` `/persona` | Chat + IM | Muestra o cambia la personalidad | | `/skills` | `/技能` | Chat + IM | Navega por la lista de habilidades disponibles | | `/id` | - | Solo IM | Muestra el ChatID de la sesión/canal actual | | `/sub` | `/订阅` | Solo IM | Añade la sesión actual a la lista de mensajes proactivos | | `/unsub` | `/取消订阅` | Solo IM | Elimina la sesión actual de la lista de mensajes proactivos | | `/plan` * | `/计划` | Chat + IM | Cambia al modo plan (solo lectura) | | `/read` * | `/只读` | Chat + IM | Cambia al modo solo lectura (confirmar cada acción) | | `/edit` * | `/编辑` | Chat + IM | Cambia al modo de aceptar ediciones | | `/yolo` * | - | Chat + IM | Cambia al modo Yolo (autonomía total) | | `/cowork` * | `/协作` | Chat + IM | Cambia al modo de colaboración (sub-agentes) | | `/goal` * | `/目标` | Chat + IM | Cambia al modo objetivo (bucle autónomo) | | `/