Guía de repositorio

YAAS

Un video de YouTube completo a partir de una sola idea. Gratis y en tu ordenador.

YAAS investiga un tema, comprueba los datos, escribe el guion, graba la voz, busca imágenes, renderiza el video y te ayuda a publicarlo. Todo desde una aplicación local. Esta guía te lleva de cero a tu primer Short.

Qué hace, paso a paso

Cada video pasa por siete agentes, siempre en este orden.

  1. Investigar

    Busca ideas y contexto del tema, atento a lo que está en tendencia.

    Gemini, Google Trends, Wikipedia, Hacker News, arXiv

  2. Comprobar datos

    Trae contexto de Wikipedia y arXiv, pide a la IA que no lo contradiga y lista las fuentes en la descripción.

    Wikipedia, arXiv

  3. Guion

    Escribe el guion. Si una IA falla, pasa a la siguiente y el video no se detiene.

    Gemini, Groq, OpenRouter, Pollinations

  4. Imágenes

    Busca imágenes en cadena y escribe los créditos en la descripción.

    Pexels, Pixabay, NASA, Openverse, imágenes de IA

  5. Voz

    Locución con voz neuronal y subtítulos sincronizados palabra a palabra.

    Edge TTS

  6. Render

    Shorts 9:16 con subtítulos grandes, o videos 16:9 con capítulos y movimiento de cámara.

    MoviePy

  7. Publicar

    Te ayuda con el título (seis alternativas), la descripción, las etiquetas y la miniatura. Sube o programa en YouTube.

    YouTube Data API

Antes de empezar

  • Python 3.10, 3.11 o 3.12Con 3.13 o superior la instalación suele fallar, porque no hay paquetes ya compilados para la versión de numpy que usa.
  • ffmpeg en el PATHLo necesita MoviePy para renderizar. Se instala en el paso 1.
  • GitPara clonar el repositorio.
  • Una clave gratuita de Gemini (recomendada)No hace falta para probarlo, pero los guiones salen mucho mejor y con menos fallos.
  • Cuenta de Google Cloud (solo si quieres subir a YouTube desde la app)Si no, descargas el MP4 y lo subes tú.

Lo que conviene saber

  • Todos los videos llevan una marca de agua semitransparente de raunakpatil.com, y no se puede quitar.
  • Los servicios gratuitos sin clave pueden limitar peticiones o cambiar sin aviso. YAAS reintenta y pasa a la siguiente fuente.
  • Sin ninguna clave, los guiones los escribe una IA de reserva y las imágenes salen de NASA, Openverse e imágenes de IA.

Instalación y primer Short

  1. Instala ffmpeg

    MoviePy necesita ffmpeg para renderizar. Comprueba después con ffmpeg -version.

    WindowsDescárgalo de ffmpeg.org, descomprímelo y añade la carpeta bin al PATH.
    Macbrew install ffmpeg
    Ubuntu / Debiansudo apt install ffmpeg
  2. Clona el repositorio e instala las dependencias

    Con Python 3.10 a 3.12 ya instalado. No actualices moviepy ni numpy: están fijados a propósito.

    git clone https://github.com/raunakpatil/youtube-agentic-ai-studio.git
    cd youtube-agentic-ai-studio
    pip install -r requirements.txt
  3. Desbloquea los pasos 3 a 6

    Pon tu email y sigue con la guía: arrancar la app, la clave de Gemini, tu primer Short y qué hacer si algo falla.

    Tienes acceso a toda la guía.
  4. Arranca la aplicación

    Se abre en tu navegador, en local. Nada sale de tu ordenador salvo las peticiones a los servicios gratuitos.

    python gui.py

    Abre http://localhost:7070.

  5. Añade tu clave de Gemini

    Consíguela gratis en aistudio.google.com/apikey (un minuto). En la app, abre Settings arriba a la derecha, pégala y pulsa Save. Se guarda en un archivo .env local que git ignora.

  6. Crea tu primer Short

    En Home escribe un tema, elige Short y pulsa Make video. Investigar y escribir tarda menos de un minuto; el render de un Short, unos minutos. Después, en Review & publish, revisa el título, la descripción y la miniatura, y descarga el MP4 o súbelo.

  7. Si algo falla

    • La voz da error 403: Microsoft cambia a veces su servicio gratuito. Actualiza con pip install -U edge-tts.
    • El texto sale pequeño o feo: faltan fuentes en el sistema. En Ubuntu, sudo apt install fonts-dejavu. Windows ya las trae.
    • La subida a YouTube dice "access denied": borra youtube_token.json, sube de nuevo y comprueba que tu cuenta de Google figura como usuario de prueba en la pantalla de consentimiento OAuth.

Preguntas frecuentes

¿Cuesta algo?

No. Cada servicio tiene capa gratuita o no pide cuenta, y el render corre en tu ordenador.

¿Necesito claves?

No para probarlo. Con una clave gratuita de Gemini los guiones mejoran mucho.

¿Cuánto tarda un video?

Investigar y escribir, menos de un minuto. Un Short se renderiza en unos minutos; un video de 6 a 8 minutos, entre 3 y 10 según tu procesador.

¿Puedo quitar la marca de agua?

No. Es el crédito de la herramienta gratuita. Lo que sí puedes desactivar es la línea de crédito de la descripción, en Settings.

¿Puedo usarlo sin subir a YouTube?

Sí. Descarga el MP4, la miniatura y los subtítulos desde Review & publish y súbelos donde quieras.