# Instrucciones para el agente: VibeFrame: genera vídeo con un presupuesto controlado

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/vericontext/vibeframe (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/vibeframe-video-agent

---

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

Comprueba Node.js ≥22 y npm, Git, FFmpeg y Chrome o Chromium. Para la ruta del instalador, comprueba curl y Bash y abre una carpeta de trabajo donde crear brief.md y el proyecto launch. El [instalador](https://vibeframe.ai/install.sh) clona y compila el proyecto; instala pnpm si falta. `@hyperframes/producer`, usado por la CLI, exige Node ≥22 aunque el README de VibeFrame anuncie ≥20. Añade `~/.local/bin` a PATH o abre una terminal nueva según el mensaje del instalador antes de llamar a `vibe`. Revisa el script antes de ejecutarlo.

### Paso 1: instala y comprueba dependencias

El README publica este instalador; revisa el script oficial antes de ejecutarlo:

```bash
curl -fsSL https://vibeframe.ai/install.sh | bash
vibe doctor
```

### Paso 2: prepara el documento de objetivos

Crea `brief.md`, el documento de objetivos (brief), con el objetivo, la duración y los requisitos visuales del vídeo. Los ejemplos oficiales son:

```bash
vibe init launch --from brief.md
vibe build launch --dry-run --max-cost 5
```

### Paso 3: genera y revisa

Configura únicamente los proveedores previstos mediante vibe setup o variables de entorno, como indica el README. Solo si aceptas la estimación y has comprobado esos accesos:

```bash
vibe build launch --max-cost 5
vibe render launch -o renders/final.mp4
vibe inspect render launch --cheap
```

## Comprobación

La simulación con `--dry-run` debe mostrar el plan, las claves requeridas y la estimación sin generar recursos de pago. Después de la ejecución, abre el MP4 y contrástalo con el documento de objetivos.

## Si algo falla

Usa doctor para requisitos ausentes. Si el coste supera el techo, ajusta el proyecto y repite la simulación. Lee las acciones de recuperación del error antes de intentar otra generación.

Fuente: [documentación oficial](https://github.com/vericontext/vibeframe#readme).