Repolode
GhostPeony

GhostPeony/clip-finder

Busca semântica auto-hospedada em transcrições do YouTube para encontrar e acessar timestamps exatos em canais, playlists ou vídeos.

Estrelas
55
Forks
6
Issues abertas
0
Último commit
há 4 meses

O que é?

O SearchTube indexa transcrições do YouTube de um canal, playlist ou vídeo individual e permite buscar pelo significado, em vez de usar palavras-chave exatas. Cada resultado leva ao timestamp correspondente no vídeo, para você ir direto ao trecho relevante.

Ele funciona em dois modos. O modo local não exige login e armazena os vetores em um diretório local do ChromaDB; você fornece sua própria chave do Gemini pelo navegador. O modo Supabase adiciona autenticação de usuários, Postgres com pgvector, cotas de uso e chaves do Gemini hospedadas no servidor, com opção de armazenamento criptografado de chaves individuais por usuário.

A stack inclui um frontend em React e um backend em FastAPI, com embeddings do Gemini para recuperação. O projeto também inclui um script de avaliação para comparar modelos e dimensões de embeddings antes de alterar os padrões.

Recursos principais

  • 01Busca semântica em transcrições do YouTube com links para timestamps
  • 02Indexação de canais, playlists e vídeos individuais
  • 03Ignora vídeos que já foram indexados
  • 04Modo local sem autenticação ou modo Supabase com login multiusuário
  • 05Suporte para usar sua própria chave no navegador ou armazenamento criptografado no servidor
  • 06Downloads de transcrições no formato SRT e histórico de buscas recentes

Casos de uso

  • Encontrar uma explicação específica em uma série longa de aulas ou em um canal de tutoriais
  • Pesquisar um tópico em uma playlist sem assistir a todos os vídeos
  • Executar uma busca privada e auto-hospedada em transcrições para uma equipe ou um arquivo pessoal

Início rápido

  1. 1

    Clone o repositório

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

    Crie um ambiente virtual do Python e instale as dependências do backend

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

    Instale as dependências do frontend e, em seguida, crie .env.local com sua chave de API do Gemini

    npm install
  4. 4

    Inicie o backend em um terminal e o frontend em outro; depois, abra http://localhost:3001

    python backend/server.py npm run dev

Antes de usar

  • O modo local precisa de uma chave de API do Gemini para embeddings e buscas.
  • As instruções de configuração usam o comando de ativação do venv específico do Windows; outras plataformas precisam de um comando diferente.
  • Não há transcrições disponíveis para vídeos sem legendas ou com restrições regionais ou de idade.

Tópicos

Perguntas frequentes

O que é clip-finder?
Busca semântica auto-hospedada em transcrições do YouTube para encontrar e acessar timestamps exatos em canais, playlists ou vídeos. O SearchTube indexa transcrições do YouTube de um canal, playlist ou vídeo individual e permite buscar pelo significado, em vez de usar palavras-chave exatas. Cada resultado leva ao timestamp correspondente no vídeo, para você ir direto ao trecho relevante.
clip-finder é gratuito? Qual é a licença?
clip-finder é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
clip-finder ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de clip-finder foi em 2 de jul. de 2026.
Para que posso usar clip-finder?
Encontrar uma explicação específica em uma série longa de aulas ou em um canal de tutoriais Pesquisar um tópico em uma playlist sem assistir a todos os vídeos Executar uma busca privada e auto-hospedada em transcrições para uma equipe ou um arquivo pessoal
Como instalar clip-finder?
Clone o repositório: git clone https://github.com/GhostPeony/SearchTube.git Crie um ambiente virtual do Python e instale as dependências do backend: python -m venv venv venv\Scripts\activate pip install -r requirements.txt Instale as dependências do frontend e, em seguida, crie .env.local com sua chave de API do Gemini: npm install Inicie o backend em um terminal e o frontend em outro; depois, abra http://localhost:3001: python backend/server.py npm run dev
Onde consigo clip-finder?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/GhostPeony/clip-finder

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados