Repolode
GhostPeony

GhostPeony/clip-finder

Búsqueda semántica autogestionada en transcripciones de YouTube para encontrar fragmentos y saltar a marcas de tiempo exactas en canales, listas de reproducción o videos.

Estrellas
55
Forks
6
Issues abiertos
0
Último commit
hace 4 meses

¿Qué es?

SearchTube indexa las transcripciones de un canal, una lista de reproducción o un video de YouTube y permite buscar por significado, en lugar de depender de palabras clave exactas. Cada resultado enlaza con la marca de tiempo correspondiente del video para que puedas ir directamente al fragmento relevante.

Funciona en dos modos. El modo local no requiere iniciar sesión y guarda los vectores en un directorio local de ChromaDB; debes proporcionar tu propia clave de Gemini desde el navegador. El modo Supabase añade autenticación de usuarios, Postgres con pgvector, cuotas de uso y claves de Gemini alojadas en el servidor, con la opción de almacenar las claves de cada usuario de forma cifrada.

La arquitectura consta de un frontend en React y un backend en FastAPI, que usa embeddings de Gemini para la recuperación. El proyecto también incluye un script de evaluación para comparar modelos y dimensiones de embeddings antes de cambiar los valores predeterminados.

Funciones clave

  • 01Búsqueda semántica en transcripciones de YouTube con enlaces a marcas de tiempo
  • 02Indexación de canales, listas de reproducción y videos individuales
  • 03Omite los videos que ya están indexados
  • 04Modo local sin autenticación o modo Supabase con inicio de sesión multiusuario
  • 05Compatibilidad con claves propias en el navegador o almacenamiento cifrado en el servidor
  • 06Descarga de transcripciones en formato SRT e historial de búsquedas recientes

Casos de uso

  • Encontrar una explicación específica dentro de una serie larga de clases o un canal de tutoriales
  • Buscar un tema en una lista de reproducción sin tener que ver todos los videos
  • Usar una búsqueda de transcripciones privada y autogestionada para un equipo o un archivo personal

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/GhostPeony/SearchTube.git
  2. 2

    Crea un entorno virtual de Python e instala las dependencias del backend

    python -m venv venv venv\Scripts\activate pip install -r requirements.txt
  3. 3

    Instala las dependencias del frontend y, después, crea .env.local con tu clave de API de Gemini

    npm install
  4. 4

    Inicia el backend en una terminal y el frontend en otra; luego abre http://localhost:3001

    python backend/server.py npm run dev

Antes de usarlo

  • El modo local necesita una clave de API de Gemini para las incrustaciones y la búsqueda.
  • Las instrucciones de configuración usan el comando de activación de venv específico de Windows; en otras plataformas se necesita un comando distinto.
  • No hay transcripciones disponibles para los videos sin subtítulos o con restricciones regionales o de edad.

Temas

Preguntas frecuentes

¿Qué es clip-finder?
Búsqueda semántica autogestionada en transcripciones de YouTube para encontrar fragmentos y saltar a marcas de tiempo exactas en canales, listas de reproducción o videos. SearchTube indexa las transcripciones de un canal, una lista de reproducción o un video de YouTube y permite buscar por significado, en lugar de depender de palabras clave exactas. Cada resultado enlaza con la marca de tiempo correspondiente del video para que puedas ir directamente al fragmento relevante.
¿clip-finder es gratuito? ¿Qué licencia tiene?
clip-finder es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿clip-finder sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de clip-finder fue el 2 jul 2026.
¿Para qué puedo usar clip-finder?
Encontrar una explicación específica dentro de una serie larga de clases o un canal de tutoriales Buscar un tema en una lista de reproducción sin tener que ver todos los videos Usar una búsqueda de transcripciones privada y autogestionada para un equipo o un archivo personal
¿Cómo se instala clip-finder?
Clona el repositorio: git clone https://github.com/GhostPeony/SearchTube.git Crea un entorno virtual de Python e instala las dependencias del backend: python -m venv venv venv\Scripts\activate pip install -r requirements.txt Instala las dependencias del frontend y, después, crea .env.local con tu clave de API de Gemini: npm install Inicia el backend en una terminal y el frontend en otra; luego abre http://localhost:3001: python backend/server.py npm run dev
¿Dónde consigo clip-finder?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/GhostPeony/clip-finder

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados