# Instrucciones para el agente: VoiceStudio: genera, transcribe y dobla audio con motores locales

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/debpalash/VoiceStudio (licencia AGPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/voicestudio-local-voice-lab

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: identifica equipo e instalación existente

Sigue la [guía oficial para agentes](https://github.com/debpalash/VoiceStudio/blob/f3731e237cec3aa9f6234b03b7cf384b0fbf3a67/docs/install/agent.md). Comprueba sistema, arquitectura, GPU, memoria, disco libre y datos de una instalación anterior. Consulta la guía de tu plataforma enlazada desde el README. Si vienes de Tauri, sigue la migración antes de instalar Electron y conserva los datos existentes.

### Paso 2: instala una versión publicada

Descarga desde [Releases](https://github.com/debpalash/VoiceStudio/releases/latest) el paquete Electron adecuado para tu sistema. Como alternativa en macOS o Linux, el README ofrece:

```sh
curl -fsSL https://voicestudio.sh/install | sh
```

Para esta ruta comprueba curl y una herramienta SHA-256, requisitos del README. No necesitas preparar las herramientas de compilación de la opción --main para instalar una versión publicada. Este comando descarga y ejecuta el instalador oficial. Revisa su comportamiento en docs/install/script.md antes de elegirlo. Para Windows y los formatos de paquete alternativos, usa la guía de plataforma del proyecto.

### Paso 3: configura el motor y genera un clip

Abre la aplicación y elige un motor compatible con el equipo detectado. Antes de descargar un modelo, comunica su tamaño y licencia y solicita confirmación, como exige la guía del proyecto. Deja las opciones de servicios remotos y estadísticas a elección del usuario.

En Voice cloning, usa una voz de muestra incluida o una referencia autorizada, escribe un texto breve y genera. Escucha el archivo para comprobar que la inferencia terminó y la salida es utilizable. Confirma el dispositivo real de cálculo, sin deducir aceleración solo por el nombre de la GPU.

### Paso 4: conecta el agente por MCP

Con VoiceStudio abierto, usa Integrations para exportar la configuración del cliente. La [documentación MCP](https://github.com/debpalash/VoiceStudio/blob/f3731e237cec3aa9f6234b03b7cf384b0fbf3a67/docs/mcp.md) indica este endpoint predeterminado:

```text
http://localhost:3900/mcp/
```

Conserva la barra final y usa el puerto real del backend si es distinto. Selecciona un cliente con Streamable HTTP y empieza por check_health y list_voices. Mantén esta primera conexión en el mismo equipo.

## Comprobación

Comprueba que el backend responde, check_health identifica el dispositivo y el clip generado se reproduce. La guía de agentes documenta /health y /openapi.json en la dirección del backend para inspeccionar estado y API. Informa de versión, motor, dispositivo efectivo y ubicación del audio.

## Si algo falla

Si un modelo no termina de descargar, consulta docs/downloading-models.md y docs/install/troubleshooting.md desde el README. Para un error de MCP, comprueba el puerto y /mcp/; las versiones antiguas pueden rechazar la ruta sin barra final. Los argumentos audio_path y ref_audio_path requieren configurar OMNIVOICE_MCP_BASE_PATH en el backend; consulta sus límites antes de dar acceso a archivos. No arranques otro backend como primer intento de reparación.