Arta Edit Studio — setup
Prepara un clon fresco para /reel-story y /reel-split, y luego personalízalo.
Explica cada paso en una frase sencilla antes de ejecutarlo — muchos usuarios no son
desarrolladores. Pregunta antes de descargar o instalar cualquier cosa (paquetes, fuentes,
pesos de modelos) y di aproximadamente cuánto ocupa.
Argumentos: $ARGUMENTS
1. Verifica la máquina — reporta como tabla ✅ / ❌
| Necesidad | Comprobar | Solución si falta |
|---|---|---|
| Python ≥ 3.10 | python --version | python.org |
| Node ≥ 18 | node --version | nodejs.org (LTS) |
| ffmpeg con zscale | ffmpeg -hide_banner -filters contiene zscale | Windows: build "full" de gyan.dev · macOS: brew install ffmpeg |
| GPU NVIDIA (opcional) | nvidia-smi | ninguna → Whisper funciona en CPU, ~10× más lento |
| Chrome para renderizado | npx hyperframes doctor (después del paso 2) | doctor dice qué hacer |
2. Instala (pregunta primero)
python -m venv .venv- PyTorch — el comando de pytorch.org para este SO; con GPU NVIDIA elige la build CUDA (~2.5 GB), si no CPU.
.venv/Scripts/python -m pip install -r requirements.txt(macOS/Linux:.venv/bin/python).npm install(renderizador HyperFrames, GSAP, iconos Lucide).npx hyperframes doctor— corrige lo que marque.- Indica al usuario: el modelo
large-v3de Whisper (~3 GB) se descarga en la primera transcripción.
3. Fuentes
Lee fonts en la configuración. Para cada archivo que falte en font/, explica al usuario de dónde
viene la fuente gratuita predeterminada y ofrece descargarla (pregunta primero):
- Farsi
Vazirmatn-Medium.ttf— github.com/rastikerdar/vazirmatn (releases), OFL - Latín
Poppins-SemiBold.ttfy displayPoppins-Black.ttf— fonts.google.com/specimen/Poppins, OFL
Cualquier otra fuente funciona: coloca el archivo en font/ y cambia la ruta en la configuración.
4. Configuración personal
Si reel.config.json no existe, cópialo de reel.config.example.json, luego pregunta
en un solo mensaje (omite lo que los argumentos ya respondieron):
- nombre y handle de Instagram (para la tarjeta de seguimiento)
- idioma hablado de los videos (
fa,en,ar,de, …) - nombre del producto / marca (opcional) y sus colores — o un archivo de logo para extraer colores
- imágenes de mascota / personaje (opcional) → colócalas en
assets/mascot/; un logo →assets/brand/logo.png - dónde están sus clips de B-roll (por defecto
assets/broll/)
Escribe las respuestas en reel.config.json (mantén todas las claves que tiene el ejemplo).
5. Prueba de humo
.venv/Scripts/python -X utf8 -c "import sys; sys.path.insert(0,'tools'); import config, story_build, showcase_build; print('tools ok')"- Si ya hay un video en
raw/:$PY tools/face_track.py <toma>debería imprimir la posición de la cara.
6. Entrega
Imprime un breve "cómo usar" con un ejemplo de cada uno, en el idioma del usuario:
/reel-story <toma> <tema, palabra clave de comentario, nombres> y /reel-split <toma> ….