# Instrucciones para el agente: Voice-Pro: transcribe, traduce y prepara doblajes

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/abus-aikorea/voice-pro (licencia GPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/voice-pro-speech-workbench

---

## 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

### Preparación

Para esta ruta Windows, comprueba Windows 10/11 de 64 bits, Git o una descarga ZIP, ≥4 GB de RAM, ≥20 GB libres y acceso a internet. start.bat prepara uv, Python 3.12 y las dependencias en installer_files; no necesitas instalar Python, pip ni CUDA Toolkit por separado. Si usas NVIDIA, el README pide ≥4 GB de VRAM (prefiere ≥8) y recomienda controlador ≥570; el arranque también detecta CPU. macOS Apple Silicon y Linux tienen su propia ruta start.sh.

Descarga el código con el comando oficial:

```sh
git clone https://github.com/abus-aikorea/voice-pro.git
```

En Windows, abre la carpeta y ejecuta `start.bat` según el README. Puede descargar un FFmpeg portable sin el configurador de sistema. Para macOS y Linux, consulta la variante `start.sh` y sus requisitos.

## Comprobación

Procesa un audio corto y compara su transcripción con lo que realmente se escucha. Revisa la traducción y el doblaje antes de exportar.

## Si algo falla

Si no arranca, consulta la detección de CPU/GPU y las descargas del primer inicio. Si la traducción falla, revisa el servicio configurado y los avisos de líneas no traducidas.

Consulta [el README oficial](https://github.com/abus-aikorea/voice-pro#readme) para requisitos y variantes de instalación.