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.
Qué es PeakCut y quién lo hace
- Repositorio: github.com/haziqahmedqasmi/PeakCut. No publica versiones numeradas: analizamos el commit
1bef2b4del 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,
ffmpegpara cortar y renderizar,yt-dlppara descargar,sherpa-onnxcon 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:
- Descarga con
yt-dlp(solo de sitios de vídeo conocidos) o lee el archivo que subes. - 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.
- 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. - Ajusta los cortes para que empiecen al inicio de una línea y acaben donde termina una frase.
- 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:
# Windows
winget install Gyan.FFmpeg
# macOS
brew install ffmpeg
# Linux (Debian/Ubuntu)
sudo apt install ffmpegClona 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.
git clone https://github.com/haziqahmedqasmi/PeakCut C:\peakcut
cd C:\peakcut
pip install -r requirements.txt
python -m studio.serverEn 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:
PEAKCUT_DATA=/tmp/peakcut-prueba PEAKCUT_PORT=8766 python -m studio.serverElegir 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.
| Opción | Qué pagas | Cuándo elegirla |
|---|---|---|
| Sin clave | Nada | Probar la app. Elige por volumen, sin títulos ni ganchos buenos. |
| Ollama (modelo local) | Nada, salvo tu hardware | Tienes una GPU decente y quieres que nada salga de tu equipo. |
| Gemini o Groq | Su nivel gratuito, con límites de uso | La opción más barata con un modelo en la nube. |
| OpenAI, Claude, Grok, OpenRouter | Lo que consumas en su API | Ya tienes cuenta y saldo en uno de ellos. |
| Custom | Depende del proveedor | Cualquier 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».
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:
PEAKCUT_ASR_MODEL=sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int8Al 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.
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.
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.comRequisitos 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.jsonydatasi ya tenías clips). - Subtítulos en inglés inventado con un vídeo en español: falta
PEAKCUT_ASR_MODELcon 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
winget install Gyan.FFmpeg
git clone https://github.com/haziqahmedqasmi/PeakCut C:\peakcut
cd C:\peakcut
pip install -r requirements.txt
python -m studio.servergit clone https://github.com/haziqahmedqasmi/PeakCut ~/peakcut
cd ~/peakcut
pip install -r requirements.txt
python -m studio.serverPEAKCUT_ASR_MODEL=sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int82. Elige tu caso
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
- Abre la URL que te da el agente (
http://127.0.0.1:8765) y sigue el recorrido de 8 pasos. - Sube un vídeo propio de pocos minutos sin clave de IA para comprobar que los subtítulos salen en español.
- Añade la clave en **Settings → AI** (Gemini o Groq para empezar barato, Ollama si quieres todo en local) y pulsa **Save and test**.
- Si quieres títulos y ganchos en español, pide al agente que cambie en
studio/brain.pyla línea «Write hook, title, description, hashtags and highlight_words in English».
Quiero desplegar PeakCut (https://github.com/haziqahmedqasmi/PeakCut) en mi VPS con Docker para varios creadores.
1. Lee README.md, DEPLOY.md y AGENTS.md del repo antes de tocar nada; sus reglas mandan.
2. Prepara el .env desde .env.example: PEAKCUT_DOMAIN, POSTGRES_PASSWORD, PEAKCUT_ACCOUNTS=1 y PEAKCUT_ASR_MODEL=sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int8. Deja vacías las claves y secretos: los pondré yo en el panel o en las variables del servidor, nunca en el repo ni en el chat.
3. Si el servidor ya tiene Coolify, Traefik o Nginx, usa la variante de deploy/ que corresponda en lugar de Caddy y explícame por qué.
4. Comprueba que el servidor cumple lo que pide DEPLOY.md (núcleos, RAM, disco) y avísame si se queda corto.
5. Levanta docker compose up -d --build, espera a que la app responda por https y dame el comando studio.admin grant para hacerme administrador.
6. Termina con una lista de lo que falta: apps OAuth de YouTube, Instagram y TikTok, y qué revisión necesita cada una.3. Guía de uso
- Entra en tu dominio, crea tu cuenta y ejecuta en el servidor el
studio.admin grantque te dio el agente. - Añade la clave de IA en **Settings → AI** y crea un espacio de trabajo por creador.
- Registra las apps de publicación desde **Settings → Connected apps → Set up**: la dirección de redirección aparece con un botón para copiar.
- Hasta que Google, Meta y TikTok revisen tus apps, publica en privado o con cuentas de prueba y revisa los clips antes de activar la publicación automática.
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.
- Compártelo con alguien a quien le sirvaWhatsAppLinkedInXFacebook
- Conoce a nuestro patrocinadorSafe Build Labs
Más sobre Herramientas open source

- Alternativas gratis a apps de pago
- Diseño, imagen y vídeo

- Claude Code
- Alternativas gratis a apps de pago

- Claude Code
- Alternativas gratis a apps de pago