ia5go/bvd-transcribe

bvdTranscribe

Você executa tudo sozinho. O usuário pode ser iniciante: não peça que ele rode comandos. Ele só informa o arquivo (ou arrasta para o terminal) e, se quiser o modo rápido, cola a chave da Groq uma vez.

<skill> = a pasta deste SKILL.md (onde também está o transcrever.py).

Passo 1. Preparar o ambiente (só na primeira vez)

Pule este passo se <skill>/.venv já existir.

1. Ache o Python: teste python --version, py --version, python3 --version. Se nenhum funcionar (ou abrir a Microsoft Store), instale: Windows winget install -e --id Python.Python.3.12 --accept-package-agreements --accept-source-agreements (depois peça para reabrir o terminal e o Claude Code); Mac brew install python; Linux pelo gerenciador de pacotes.
2. Crie o ambiente isolado da skill: <python> -m venv "<skill>/.venv".
3. Instale as dependências nele, em silêncio: <venv-python> -m pip install --quiet -r "<skill>/requirements.txt".
   • <venv-python> é <skill>/.venv/Scripts/python.exe no Windows e <skill>/.venv/bin/python no Mac/Linux.
   • Não precisa instalar ffmpeg: o imageio-ffmpeg já traz um.

Passo 2. Escolher o modo (só na primeira vez)

• Local (padrão): roda 100% no computador, grátis, privado, sem conta. Na primeira vez baixa o modelo (~500 MB) e é mais lento que a nuvem. Nada a configurar.
• Groq (opcional, mais rápido): se a variável GROQ_API_KEY já existir, o script usa a Groq automaticamente. Para ativar, explique em uma frase: "Crie uma conta grátis em https://console.groq.com, vá em API Keys, clique em Create API Key e cole a chave aqui." Salve de forma permanente (Windows: setx GROQ_API_KEY "<chave>"; Mac/Linux: export GROQ_API_KEY="<chave>" no ~/.zshrc ou ~/.bashrc) e, na sessão atual, passe a chave como variável de ambiente só do comando.

Se o usuário não falar nada, use o local. Se ele pedir "local" ou "sem internet", adicione --local mesmo com a chave configurada.

Passo 3. Transcrever

<venv-python> "<skill>/transcrever.py" "<caminho do arquivo>" pt

• Troque pt pelo idioma do vídeo se for outro (en, es...).
• Opcional no modo local: --modelo=medium (mais preciso, mais lento) ou --modelo=base (mais rápido, menos preciso). Padrão: small.
• Vídeos longos são divididos em partes de 10 min automaticamente. No limite gratuito da Groq o script espera e continua sozinho; só avise.
• Rode em segundo plano se o arquivo for longo (mais de ~10 min no modo local).
• Erros comuns: caminho com aspas erradas (refaça com aspas), chave inválida (peça de novo ou use --local), arquivo sem áudio (avise).

Passo 4. Entregar

O script cria a pasta <nome do vídeo>_transcricao ao lado do vídeo, com:

• .txt: texto corrido
• .srt: legenda para editor de vídeo ou YouTube
• .md: texto com marcação [mm:ss] em cada trecho

Responda em no máximo 5 linhas: onde está a pasta, a duração, o modo usado e um resumo de 2 ou 3 frases do que foi dito. Depois ofereça, em uma linha: revisar nomes próprios, tirar os principais pontos, virar legenda de post ou roteiro. Não altere os arquivos gerados sem pedido; se pedirem revisão, salve como <nome>_revisado.md ao lado.