¿Qué hace RESUMEN-VIDEOS?
Resume vídeos técnicos locales (ingeniería, formaciones, presentaciones, reuniones) en un MP4 hecho con fragmentos originales, analizando a la vez la voz y la pantalla. Úsala cuando pidan resumir, condensar o extraer lo esencial de un vídeo o grabación local, o ante /resumir-video o $resumir-video seguido de una ruta y, opcionalmente, indicaciones como la duración objetivo. Requiere Python 3.10+ y FFmpeg.
¿Qué hace?
Extrae los fragmentos más relevantes de un vídeo técnico local y los combina en un nuevo vídeo MP4 resumido. Analiza tanto el audio (mediante transcripción con Whisper) como el contenido visual de la pantalla (detectando cambios importantes, como diapositivas o código), para seleccionar los segmentos clave. El resultado es un resumen coherente y natural que conserva la esencia del original.
¿Cómo usarla?
Invoca la habilidad mediante:
/resumir-video [ruta] [opciones]$resumir-video [ruta] [opciones]
El agente de IA detectará automáticamente la intención de resumir un vídeo y ejecutará el flujo completo: transcripción, análisis visual, selección de fragmentos y renderizado del MP3 (y opcionalmente MP4 si se especifica).
Opciones disponibles
| Opción | Descripción | Valor por defecto |
|---|---|---|
--duracion o -d | Duración objetivo del resumen en segundos (mín. 60, máx. 600) | 180 (3 minutos) |
--idioma o -l | Idioma del audio (ej. es, en) | es |
--num-fragmentos o -n | Número máximo de fragmentos a incluir (mín. 1, máx. 20) | 5 |
--salida o -o | Ruta y nombre del archivo de salida (sin extensión) | Autogenerado |
Ejemplo de uso
/resumir-video /home/usuario/videos/reunion_ingenieria.mp4 --duracion 120 --num-fragmentos 3
Esto generará un resumen de 2 minutos con 3 fragmentos del vídeo original.
Requisitos del sistema
- Python 3.10 o superior
- FFmpeg instalado y accesible en el PATH
- GPU compatible con CUDA (NVIDIA) o MPS (Apple Silicon) para aceleración (opcional, pero recomendado para vídeos largos)
- Dependencias Python:
whisper,moviepy,numpy,opencv-python-headless,torch,tqdm
Instalación de dependencias
pip install whisper moviepy numpy opencv-python-headless torch tqdm
Asegúrate de que FFmpeg esté instalado:
# Ubuntu/Debian
sudo apt install ffmpeg
# macOS (Homebrew)
brew install ffmpeg
# Windows (Chocolatey)
choco install ffmpeg
Variables de entorno (opcionales)
| Variable | Descripción | Valor por defecto |
|---|---|---|
WHISPER_MODEL | Modelo de Whisper a usar (tiny, base, small, medium, large) | base |
DEVICE | Dispositivo para PyTorch (cpu, cuda, mps) | Auto-detectado |
OUTPUT_DIR | Directorio donde guardar los resúmenes generados | Directorio actual |
Limitaciones
- Vídeos de más de 2 horas pueden requerir mucha memoria RAM y tiempo de procesamiento.
- La calidad del resumen depende de la claridad del audio y la estabilidad visual de la grabación.
- No procesa vídeos con DRM ni formatos no soportados por FFmpeg.
- El análisis visual se centra en cambios de escena y contenido de diapositivas; puede no ser óptimo para vídeos con mucho movimiento o gráficos complejos.
Notas adicionales
- El resumen generado es un vídeo MP4 con codec H.264, compatible con la mayoría de reproductores.
- Los fragmentos se ordenan cronológicamente para mantener la coherencia narrativa.
- Si se solicita sin la flag
--salida, el nombre del archivo se genera automáticamente basado en el original y la duración del resumen.
Para más detalles, consulta la documentación del proyecto en captia-technology/RESUMEN-VIDEOS.