~/codigoagente

PeakCut: convierte vídeos largos y directos en clips verticales con subtítulos (alternativa gratis a Opus Clip)

Al final del artículo tienes el comando, el prompt listo para copiar y un .md para descargar.

PeakCut es una aplicación open source que convierte vídeos largos y directos en clips verticales 9:16 con subtítulos palabra a palabra, un gancho en pantalla y título listo para publicar. Pegas un enlace de YouTube, Twitch o Kick (o subes el archivo), la transcripción se hace en tu propio equipo y una IA elegida por ti decide qué momentos merecen un clip. Hace lo mismo que servicios de pago como Opus Clip, pero corre en tu PC o en tu servidor, con licencia MIT y pagando solo lo que consuma tu clave de IA (o nada, si usas un modelo local).

La hemos instalado y probado con dos vídeos, uno en inglés y otro en español. En esta guía tienes qué hace por dentro, cómo instalarla, cuánto cuesta de verdad y el ajuste que necesitas para que los subtítulos en español salgan bien, porque con la configuración por defecto salen mal.

Panel principal con las opciones de clip: cuántos, duración, estilo de subtítulo y distribución · codigoagente

Qué es PeakCut y quién lo hace

  • Repositorio: github.com/haziqahmedqasmi/PeakCut. No publica versiones numeradas: analizamos el commit 1bef2b4 del 17 de noviembre de 2026. La propia app avisa en el panel cuando sale uno nuevo.
  • Licencia: MIT. Las tipografías de los subtítulos (Anton, Archivo Black, Poppins) van con licencia SIL Open Font License. Puedes usarlo para tus clientes sin pagar nada.
  • Stack: servidor en Python con FastAPI, ffmpeg para cortar y renderizar, yt-dlp para descargar, sherpa-onnx con el modelo Parakeet para la voz a texto, y una interfaz en HTML, CSS y JavaScript sin paso de compilación. Base de datos SQLite en tu PC o PostgreSQL en un servidor.
  • Qué incluye: clips de cualquier vídeo, recorte de directos en tiempo real, espacios de trabajo por creador, cola de publicación en YouTube, Instagram y TikTok con espaciado y límites diarios, y un panel de uso de la IA con peticiones y tokens por vídeo.

Cómo decide qué momentos recortar

El flujo de un vídeo pasa por cinco pasos, y conviene entenderlos para saber qué ajustar:

  1. Descarga con yt-dlp (solo de sitios de vídeo conocidos) o lee el archivo que subes.
  2. Transcribe en local con Parakeet 0.6b. El audio nunca sale de tu máquina; el modelo pesa unos 480 MB y se descarga solo la primera vez.
  3. Pregunta a la IA qué momentos retendrían a un desconocido. El prompt está en studio/brain.py: pide empezar en la frase que prepara el momento, terminar justo después del remate, saltarse intros y patrocinios, y devolver menos clips si no hay buenos. El README calcula unas cuatro peticiones por cada hora de vídeo.
  4. Ajusta los cortes para que empiecen al inicio de una línea y acaben donde termina una frase.
  5. Renderiza cada clip a 1080×1920 con ffmpeg: subtítulos con la palabra activa resaltada, el gancho arriba y la distribución que elijas.

Sin clave de IA también funciona: elige los tramos con más volumen que contienen voz. Es peor criterio, pero sirve para probar sin gastar nada.

En los directos graba el stream en un búfer circular y recorta mientras sigue en vivo, cruzando tres señales: el volumen, la actividad del chat y la transcripción. El chat se cuenta por personas distintas, no por mensajes, para que una lluvia de emotes de una sola cuenta no parezca entusiasmo del público. Para streams de videojuegos tiene un modo gaming (GAMING.md): reconoce 23 juegos por el título, añade sus hashtags y detecta dónde está la webcam buscando un borde recto que no se mueve entre fotogramas, para montar la distribución «Gameplay + facecam».

Instalar PeakCut en tu PC

Necesitas Python 3.10 o superior y ffmpeg:

terminalsh
# Windows
winget install Gyan.FFmpeg
# macOS
brew install ffmpeg
# Linux (Debian/Ubuntu)
sudo apt install ffmpeg

Clona el repositorio en una carpeta corta y fija. En Windows esto importa: si la ruta completa supera 260 caracteres, la librería de voz no carga.

terminalsh
git clone https://github.com/haziqahmedqasmi/PeakCut C:\peakcut
cd C:\peakcut
pip install -r requirements.txt
python -m studio.server

En macOS o Linux usa ~/peakcut. Abre http://127.0.0.1:8765: no hay inicio de sesión, entra directo al panel con un recorrido de 8 pasos. Si le pides a Claude Code o a otro agente que lo instale, el AGENTS.md del repo le obliga a preguntarte primero dónde ponerlo, para que no acabe en una carpeta temporal que se borra.

Para probarlo sin tocar datos reales, el propio repo sugiere arrancar una copia en otro puerto y otra carpeta:

terminalsh
PEAKCUT_DATA=/tmp/peakcut-prueba PEAKCUT_PORT=8766 python -m studio.server

Elegir la IA y lo que cuesta de verdad

En Settings → AI eliges el servicio, pegas la clave, pulsas Find models para ver la lista real del proveedor y luego Save and test. La clave se guarda en la carpeta de datos de tu equipo y no se vuelve a mostrar.

Ajustes de IA: servicio, clave y modelo, con un segundo modelo opcional como respaldo · codigoagente
OpciónQué pagasCuándo elegirla
Sin claveNadaProbar la app. Elige por volumen, sin títulos ni ganchos buenos.
Ollama (modelo local)Nada, salvo tu hardwareTienes una GPU decente y quieres que nada salga de tu equipo.
Gemini o GroqSu nivel gratuito, con límites de usoLa opción más barata con un modelo en la nube.
OpenAI, Claude, Grok, OpenRouterLo que consumas en su APIYa tienes cuenta y saldo en uno de ellos.
CustomDepende del proveedorCualquier API compatible con el formato de chat de OpenAI.

Dos detalles prácticos: el README recomienda un modelo rápido y barato, y puedes poner varios separados por comas en PEAKCUT_AI_MODELS para que, si el primero falla o te limita, pruebe el siguiente. La transcripción no usa la IA ni cuesta nada. Frente a un servicio de clips por suscripción, el coste con PeakCut se reduce a tu electricidad y, si eliges un proveedor en la nube, a unas pocas peticiones por hora de vídeo.

Prueba real: un vídeo en inglés y un directo en español

Montamos dos vídeos de prueba con voz sintética: una charla en inglés de 1:51 y un «directo» en español de 1:21. En un contenedor Linux sin GPU, el de inglés quedó transcrito, recortado y renderizado en 31 segundos según el propio panel. Sin clave de IA, PeakCut eligió un tramo de 57 segundos por volumen y le puso el gancho genérico «WAIT FOR IT».

El vídeo procesado y su clip: el aviso indica que, sin IA, el corte se eligió solo por volumen · codigoagente

Con el vídeo en español apareció el problema importante. El modelo por defecto es parakeet-tdt-0.6b-v2, que solo entiende inglés: transcribió «nuebo», «oy vamos ablar» y, a mitad del vídeo, se pasó al inglés con frases como «The problem is the vilidad». La versión v3 de Parakeet es multilingüe e incluye el español, y PeakCut deja cambiar el modelo con una variable:

snippettext
PEAKCUT_ASR_MODEL=sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int8

Al arrancar con esa línea en .env, descargó el modelo nuevo (otros ~480 MB) y la transcripción salió limpia: «Hoy vamos a hablar de algo que nos pasa a todos los programadores», con tildes y puntuación.

Mismo segundo del directo en español: v2 inventa inglés, v3 escribe «habilidad» · codigoagente

Hay un segundo matiz que leímos en el código y conviene saber antes de usarlo con contenido en español:

  • Con la IA activa, el gancho, el título, la descripción y los hashtags se piden en inglés (salvo hindi y urdu). Está escrito en el prompt de studio/brain.py; como es MIT, puedes cambiar esa línea por «Write them in Spanish».
  • Si el vídeo viene de YouTube y YouTube dice que está en español, los subtítulos del clip se traducen al inglés. Con archivos subidos, Twitch o Kick se mantienen las palabras dichas.

Publicar en YouTube, Instagram y TikTok

En Settings → Connected apps cada usuario pulsa Connect, inicia sesión en la plataforma y vuelve. Para eso el servidor necesita una app registrada en cada red, y ahí está la parte lenta, porque no depende de PeakCut:

  • YouTube: cliente OAuth de Google Cloud con YouTube Data API v3. Hasta que Google verifica la app, las subidas quedan privadas.
  • Instagram: app de tipo Business en Meta for Developers. Funciona con cuentas Creator y Business; hasta la revisión de Meta solo conectan las cuentas de prueba, e Instagram descarga cada clip desde un enlace firmado de tu web, así que necesitas una dirección https pública.
  • TikTok: app con Login Kit y Content Posting API. Hasta la auditoría de TikTok los clips se publican como privados.

Si gestionas clips de varios creadores y no quieres pelearte con las revisiones de Meta, Google y TikTok, una agencia como Safe Build Labs puede dejarte el servidor y las apps de publicación configurados. Con las apps aprobadas, la cola publica con espaciado entre clips y un tope diario, y el botón Pause all posting la detiene entera.

Llevarlo a un servidor con Docker

El repo trae un docker-compose.yml con tres contenedores: la app, PostgreSQL y Caddy para HTTPS automático. Hay variantes para Traefik y Nginx en deploy/, así que encaja en un VPS con Coolify.

terminalsh
cp .env.example .env    # IA, PEAKCUT_DOMAIN, POSTGRES_PASSWORD
docker compose up -d --build
docker compose exec app python -m studio.admin grant tu@correo.com

Requisitos que da DEPLOY.md si lo usarán varias personas: 8 núcleos, 16 GB de RAM y más de 200 GB de disco, porque recortar es trabajo de CPU. La transcripción va a unas 10 veces tiempo real con 4 núcleos; si se queda corta, deploy/gpu/ monta un servidor aparte con tarjeta NVIDIA solo para la voz (PEAKCUT_ASR_URL y PEAKCUT_ASR_TOKEN).

La regla de seguridad que no puedes saltarte: sin cuentas, PeakCut solo escucha en 127.0.0.1. En cualquier servidor accesible desde internet pon PEAKCUT_ACCOUNTS=1 (con Docker ya viene así). Los roles de administrador solo se cambian con el comando studio.admin en la máquina, nunca desde la web. Si es tu primer despliegue de una app con base de datos y dominio propio, el capítulo 13 de la guía Claude Code de cero a producción explica cómo desplegar en tu VPS con Coolify o Docker paso a paso. Para ver el mismo patrón con otra app, tienes cómo instalamos Paymenter en un VPS con Coolify.

Errores frecuentes

  • «DLL load failed ... The filename or extension is too long» en Windows: la carpeta está demasiado anidada. Muévela a C:\peakcut (copia .env, storage.json y data si ya tenías clips).
  • Subtítulos en inglés inventado con un vídeo en español: falta PEAKCUT_ASR_MODEL con el modelo v3.
  • «YouTube isn't letting PeakCut download videos right now»: YouTube bloquea a veces las descargas desde servidores. Sube el archivo o usa un enlace de Twitch o Kick; PeakCut vuelve a intentar YouTube a los pocos minutos.
  • Los clips solo salen con «WAIT FOR IT»: no hay IA configurada y está eligiendo por volumen. Añade una clave en Settings → AI.
  • Disco lleno: PeakCut deja de aceptar vídeos hasta que haya espacio. En Settings → Storage puedes mover la carpeta de datos a otra unidad.

Preguntas frecuentes

¿PeakCut es gratis? Sí. El código es MIT y la transcripción es local. Solo pagas la IA en la nube si eliges una; con Ollama o sin clave no pagas nada.

¿Funciona en español? Sí, si cambias el modelo de voz a Parakeet v3. Los ganchos y títulos de la IA salen en inglés salvo que edites el prompt.

¿Necesito GPU? No. Corre en CPU; una GPU NVIDIA solo acelera la transcripción en servidores con mucho volumen.

¿Puedo recortar vídeos de otros? Técnicamente sí, pero el README es claro: recorta lo que hayas hecho tú o aquello para lo que tengas permiso. Los derechos y las normas de cada plataforma son tu responsabilidad.

¿En qué se diferencia de Opus Clip? El resultado es parecido; la diferencia está en que PeakCut es tuyo: corre en tu equipo, eliges el modelo de IA, no hay límite de minutos y puedes leer y cambiar cómo decide los cortes.

Veredicto

PeakCut es la alternativa open source más completa que hemos probado para sacar Shorts, Reels y TikToks de vídeos largos y directos: transcripción local, IA a elegir, modo gaming y publicación automática. Para contenido en español, añade PEAKCUT_ASR_MODEL con el modelo v3 desde el primer día y decide si quieres los títulos en inglés o editar el prompt. El siguiente paso: instálalo en tu PC, prueba un vídeo propio sin clave y, cuando te convenza, conecta Gemini o un modelo local. Si además quieres generar vídeos desde cero con agentes, mira cómo crear vídeos con IA usando Claude Code o Codex y OpenMontage.

// recurso · úsalo directamente

PeakCut listo para usar en tu PC o tu servidor

Instálalo a mano con los comandos o pega el prompt de tu caso en Claude Code (o en otro agente) para que lo deje funcionando con subtítulos en español.

Licencia del repositorio: MIT (tipografías de subtítulos: SIL OFL)

1. Instala

Windows
winget install Gyan.FFmpeg
git clone https://github.com/haziqahmedqasmi/PeakCut C:\peakcut
cd C:\peakcut
pip install -r requirements.txt
python -m studio.server
macOS o Linux
git clone https://github.com/haziqahmedqasmi/PeakCut ~/peakcut
cd ~/peakcut
pip install -r requirements.txt
python -m studio.server
Subtítulos en español (.env)
PEAKCUT_ASR_MODEL=sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int8

2. Elige tu caso

Pega este prompt en tu agente
Quiero instalar PeakCut (https://github.com/haziqahmedqasmi/PeakCut) en este PC para sacar clips verticales de mis vídeos en español.

1. Antes de clonar, pregúntame la carpeta. Propón C:\peakcut en Windows o ~/peakcut en macOS/Linux, nunca una carpeta temporal ni tu espacio de trabajo.
2. Comprueba que tengo Python 3.10+ y ffmpeg; si falta ffmpeg, dime el comando de instalación de mi sistema y espera mi OK.
3. Clona el repo, crea un entorno virtual e instala requirements.txt.
4. Crea un .env a partir de .env.example con PEAKCUT_ASR_MODEL=sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int8 para que la transcripción entienda español.
5. Arranca python -m studio.server, espera a "Speech model ready" y dime la URL.
6. No pongas ninguna clave de IA en archivos: la añadiré yo en Settings → AI.

3. Guía de uso

  1. Abre la URL que te da el agente (http://127.0.0.1:8765) y sigue el recorrido de 8 pasos.
  2. Sube un vídeo propio de pocos minutos sin clave de IA para comprobar que los subtítulos salen en español.
  3. Añade la clave en **Settings → AI** (Gemini o Groq para empezar barato, Ollama si quieres todo en local) y pulsa **Save and test**.
  4. Si quieres títulos y ganchos en español, pide al agente que cambie en studio/brain.py la línea «Write hook, title, description, hashtags and highlight_words in English».
Prompt y guía corta en un archivoRepositoriohaziqahmedqasmi/PeakCut

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

ArtCraft, app open source para crear imágenes y vídeos con IA montando antes la escena en 2D y 3D. Qué hace, cuánto cuesta y cómo usarla con tu clave de fal.
  • Alternativas gratis a apps de pago
  • Diseño, imagen y vídeo
leer artículo
Slopus es una app de escritorio GPL-3.0 que planifica, genera y edita imágenes, vídeo y música en tu GPU. Agente, generadores locales y timeline sin FFmpeg.
  • Claude Code
  • Alternativas gratis a apps de pago
leer artículo
Breakscale es un simulador MIT de diseño de sistemas: montas tu arquitectura, subes el tráfico y ves por qué se cae. Web, VS Code y MCP para Claude Code.
  • Claude Code
  • Alternativas gratis a apps de pago
leer artículo