95e0f34d31
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese, French and German (18 pages each), mirroring the existing en/ru structure. - generate the 5 new locales in config.ts from a single strings table (nav, sidebar, search, footer, docFooter, outline, editLink) with locale-prefixed links - rework DocsCardGrid from the binary isRu check to a per-locale map so the home cards render translated copy and prefixed links for every locale
6 KiB
| title | description | lang |
|---|---|---|
| Instalación – Documentación de Agent Teams | Descarga e instala Agent Teams para macOS, Windows o Linux. Cubre las builds empaquetadas, la configuración desde el código fuente, las actualizaciones automáticas y los requisitos. | es-ES |
Instalación
Agent Teams se distribuye como una aplicación de escritorio para macOS, Windows y Linux.
::: tip La vía más rápida
- Descarga la build para tu plataforma a continuación
- Inicia la aplicación: empieza con el modelo gratuito sin autenticación o conecta la autenticación de un proveedor desde la interfaz
- Comienza el inicio rápido para crear tu primer equipo
Arranque de la aplicación de escritorio: ejecuta pnpm dev para la aplicación de Electron. No inicies el modo de desarrollo de navegador/web para el uso normal.
:::
Descargar builds
Usa la página de descarga o la última versión de GitHub cuando quieras la aplicación empaquetada:
- macOS Apple Silicon:
.dmg - macOS Intel:
.dmg - Windows:
.exe - Linux:
.AppImage,.deb,.rpmo.pacman
::: warning Windows SmartScreen Las aplicaciones de código abierto sin firmar o recién publicadas pueden activar SmartScreen. Si confías en la fuente de la versión, elige More info y luego Run anyway. :::
Requisitos
La aplicación empaquetada está diseñada para una incorporación sin configuración. Puedes empezar con el modelo gratuito sin autenticación: sin registro, claves de API ni tarjeta de crédito. Si quieres más modelos, la aplicación te guía en la detección del runtime y la autenticación del proveedor desde la interfaz.
Para modelos de pago o respaldados por una cuenta, conecta al menos un proveedor:
| Proveedor | Método de acceso |
|---|---|
| Claude (Anthropic) | Inicio de sesión de Claude Code CLI o clave de API |
| Codex (OpenAI) | Inicio de sesión de Codex CLI o clave de API |
| Gemini (Google) | Google ADC, Gemini CLI o clave de API |
| OpenCode | Modelo gratuito incluido sin autenticación, o clave de API para un backend compatible (p. ej. OpenRouter) |
::: info Gemini está disponible como una ruta de proveedor compatible. Consulta Proveedores y runtimes para conocer las opciones de autenticación y el estado actual de todos los proveedores. :::
Para el desarrollo desde el código fuente, también necesitas:
| Herramienta | Versión |
|---|---|
| Node.js | 24.16.0 LTS |
| pnpm | 10+ |
En macOS, los binarios precompilados oficiales de Node.js 24 requieren macOS 13.5+.
Ejecutar desde el código fuente
git clone https://github.com/777genius/agent-teams-ai.git
cd agent-teams-ai
pnpm install
pnpm dev
pnpm dev inicia la aplicación de escritorio de Electron con recarga en caliente. Este es el objetivo de desarrollo predeterminado — no inicies un servidor de desarrollo web de navegador para el desarrollo normal. La ruta del navegador carece del IPC de escritorio completo, la terminal, la autenticación del proveedor y el comportamiento del ciclo de vida del equipo.
La rama main lleva el último desarrollo estable. Cambia a ramas de funciones solo si necesitas un cambio específico aún no publicado.
Verificar la configuración
Después de instalar, confirma que la build esté en buen estado:
# Check that the desktop app compiles and starts
pnpm typecheck
# Verify the VitePress documentation site builds
pnpm --dir landing docs:build
Si pnpm typecheck informa de errores de tipo, busca una versión más reciente de las dependencias o de la versión fijada de TypeScript. Si pnpm --dir landing docs:build falla, inspecciona landing/product-docs/ en busca de errores de sintaxis en el markdown o la configuración.
Si estás editando esta documentación, ejecuta la build para verificar tus cambios:
pnpm --dir landing docs:build
Actualizaciones automáticas
La aplicación empaquetada busca actualizaciones automáticamente al iniciar y periódicamente mientras se ejecuta. Cuando hay una actualización disponible, la aplicación te pide que la descargues e instales. También puedes comprobarlo manualmente desde el menú de la aplicación.
::: tip
Las actualizaciones automáticas no están disponibles al ejecutar desde el código fuente. Trae los últimos cambios y vuelve a ejecutar pnpm install cuando cambien las dependencias.
:::
Actualizar desde el código fuente
Si ejecutas desde el código fuente, trae la rama main y vuelve a ejecutar la instalación cuando cambien las dependencias:
git pull
pnpm install
Después de actualizar, verifica la build y la documentación:
pnpm typecheck
pnpm --dir landing docs:build
Usa siempre pnpm dev (Electron) — no el servidor de desarrollo del navegador — para el desarrollo normal.
Próximos pasos
- Inicio rápido — desde la instalación hasta el primer equipo en ejecución
- Configuración del runtime — autenticación del proveedor y selección de modelo por runtime
- Crear un equipo — formas de equipo recomendadas y redacción del briefing
Para colaboradores
- AGENTS.md — navegación del repositorio y punteros de arquitectura
- CLAUDE.md — convenciones de trabajo y reglas del proyecto
- AGENT_CRITICAL_GUARDRAILS.md — guardrails de implementación estrictos