Publicada el · Actualizada el
ShortGPT: cómo instalarlo y configurarlo para crear vídeos cortos automáticos montaje automático con IA y código abierto
ShortGPT es un framework de código abierto que automatiza todo el pipeline de un vídeo corto: guion con un modelo de lenguaje, voz sintética, búsqueda de素材 de fondo en Pexels o YouTube, montaje con FFmpeg y MoviePy, y subtítulos quemados. Va dirigido a canales sin rostro, equipos de marketing, curiosos de la IA aplicada a vídeo y creadores que necesitan localizar contenido a más de treinta idiomas. > Aviso. El proyecto original de RayVentura está sin mantenimiento desde hace años y su instalación con versiones actuales de Python y de las dependencias suele fallar. La ficha conserva la idea aprovechable (automatizar el pipeline completo de un short) y marca en qué puntos el método descrito está desfasado.
Lo que hay dentro, de principio a fin
Qué hace ShortGPT y para quién tiene sentido piezas clave del motor
El sistema monta un vídeo corto a partir de un tema o prompt. Cuatro bloques hacen el trabajo:
- Motor de edición orientado a LLM: usa un lenguaje de marcas en JSON para que el modelo de lenguaje entienda la línea de tiempo, los cortes y la ubicación de素材.
- Búsqueda automática de素材: módulos de scraping que bajan vídeos e imágenes libres de derechos ajustados al guion.
- Síntesis de voz multilingüe: integra ElevenLabs para voz premium y EdgeTTS como alternativa gratuita.
- Pipeline de traducción de vídeo: toma un vídeo fuente, lo transcribe, lo traduce y lo dobla a más de treinta idiomas.
El repositorio público no recibe actualizaciones desde hace tiempo. Antes de invertir tiempo, comprueba en GitHub el último commit y los issues abiertos; puede que tengas que fijar versiones antiguas de las dependencias para que arranque.
Requisitos antes de empezar software, hardware y claves
| Requisito | Detalle |
|---|---|
| Sistema operativo | Windows, macOS o Linux; también se puede ejecutar en Google Colab |
| Dependencias de software | Python 3.8+, Git, FFmpeg e ImageMagick (obligatorio para que MoviePy renderice los subtítulos) |
| Hardware | Mínimo 8 GB de RAM; una GPU dedicada ayuda con el render, pero no es imprescindible si usas APIs en la nube |
| Claves de API | Una clave de OpenAI para generar guiones; opcionalmente, una clave de ElevenLabs para voces premium |
Instalación paso a paso terminal, del sistema al dashboard web
Paso 1. Instala las dependencias de sistema.
FFmpeg se encarga del vídeo y el audio; ImageMagick renderiza los textos. En Ubuntu o Debian:
sudo apt-get update sudo apt-get install ffmpeg imagemagick
En Linux, ImageMagick trae una política por defecto que bloquea el renderizado de textos en MoviePy. Toca editar el fichero de política para permitir rutas @*.
En macOS puedes instalarlos con brew install ffmpeg imagemagick.
Paso 2. Clona el repositorio.
git clone https://github.com/RayVentura/ShortGPT.git cd ShortGPT
Paso 3. Instala los requisitos de Python.
Conviene usar un entorno virtual (venv o conda) para no chocar con otros proyectos de IA de tu máquina.
python -m venv env source env/bin/activate # En Windows: env\Scripts\activate pip install -r requirements.txt
Si tu versión de Python es 3.12 o superior, requirements.txt puede no tener ruedas publicadas. Solución: crea el entorno con Python 3.10 o 3.11 y vuelve a instalar.
Paso 4. Arranca el panel web.
ShortGPT usa Gradio para ofrecer una interfaz gráfica limpia en el navegador.
python run_shortgpt.py
Abre http://localhost:31415, ve a la pestaña de ajustes y pega tu clave de OpenAI. Ya puedes generar tu primer short automático.
Errores frecuentes y cómo arreglarlos política de ImageMagick, PATH y cuotas
| Error | Qué significa | Cómo arreglarlo |
|---|---|---|
convert: not authorized (política de ImageMagick) | MoviePy no puede generar subtítulos porque la política por defecto de ImageMagick en Linux bloquea el renderizado de textos | Abre /etc/ImageMagick-6/policy.xml y comenta o elimina la línea <policy domain="path" rights="none" pattern="@*" /> |
ffmpeg: command not found | El script de Python no encuentra el binario de FFmpeg para cortar y empalmar vídeo y audio | Confirma que FFmpeg está instalado y añadido a la variable PATH del sistema (especialmente habitual en Windows) |
OpenAI API RateLimitError | Te has quedado sin créditos de OpenAI o tu cuenta nueva tiene un límite de peticiones por minuto muy bajo | Añade un método de pago válido en el panel de desarrollador de OpenAI y deposita al menos 5 EUR para subir al tier 1 |
Gratuito frente a servicios comerciales de pago coste, marcas de agua y control
| Característica | ShortGPT (código abierto) | Generadores comerciales en la nube (Invideo AI y similares) |
|---|---|---|
| Coste de software | Gratis; solo pagas tu consumo de API | Suscripción mensual de entre 20 y 50 EUR o más |
| Marcas de agua | Ninguna | Bloqueadas detrás de los planes de pago |
| Personalización | Alta: editas el código y la lógica en Python | Baja: limitado a su interfaz propietaria |
| Requisito de hardware | Necesita montaje local y potencia de proceso | Funciona en el navegador; sin requisitos de cómputo |
Si quieres construir un pipeline casero, automatizar muchos cortos al día y evitar suscripciones mensuales, ShortGPT encaja. Si prefieres abrir una pestaña, escribir un prompt y descargar el MP4, un servicio comercial te ahorra la instalación.
Tres alternativas si ShortGPT se queda corto montajes más sencillos o más pulidos
- MoneyPrinterV2. Script de Python muy popular y enfocado a generar YouTube Shorts automáticos. Comparte ADN con ShortGPT y suele presumir de una instalación más directa. Repositorio en GitHub:
FujiwaraChoki/MoneyPrinterV2. - Opus Clip. Servicio comercial premium. No genera vídeos desde cero a partir de un prompt; su fuerte es cortar podcasts o entrevistas largas en decenas de clips cortos estilo Alex Hormozi con subtítulos dinámicos. Web: opus.pro.
- Invideo AI. Generador de texto a vídeo en la nube con interfaz tipo chat. Muy fácil de usar, pero pide suscripción mensual para quitar marcas de agua. Web: invideo.io.