nekith78/neurolearn

O que neurolearn faz?

Transcrição universal de áudio/vídeo com 8 backends intercambiáveis — Whisper local (offline), legendas do YouTube, Gemini, Groq, OpenAI, Deepgram, AssemblyAI e custom compatível com OpenAI. Funciona como skill do Claude Code, comando slash ou CLI autônomo.

Visão Geral

O neurolearn permite que você transcreva arquivos de áudio, vídeo ou vídeos do YouTube usando o backend de sua escolha. Ideal para desenvolvedores que precisam de transcrições rápidas e precisas sem trocar de ferramenta.

Plataformas Suportadas

• Claude Code: Use como skill no diretório .claude/skills/ ou invoque via comando slash /transcribe.
• CLI autônomo: Execute o script diretamente em Node.js para uso em pipelines ou scripts.

Backends Disponíveis

Backend	Chave de API	Notas
whisper	Nenhuma	Whisper local (offline), requer ffmpeg e whisper-cpp ou openai-whisper
youtube	Nenhuma	Usa legendas automáticas do YouTube (sem custo)
gemini	GEMINI_API_KEY	API do Google Gemini
groq	GROQ_API_KEY	API do Groq
openai	OPENAI_API_KEY	API oficial do OpenAI Whisper
deepgram	DEEPGRAM_API_KEY	API do Deepgram
assemblyai	ASSEMBLYAI_API_KEY	API do AssemblyAI
custom	CUSTOM_OPENAI_API_KEY & CUSTOM_OPENAI_ENDPOINT	Qualquer endpoint compatível com OpenAI

Primeiros Passos

Como skill do Claude Code

1. Copie a skill para o diretório de skills:

   cp neurolearn.md ~/.claude/skills/
   

2. Defina as variáveis de ambiente necessárias (exemplo para OpenAI):

   export OPENAI_API_KEY="sua-chave-aqui"
   export NEUROLEARN_BACKEND="openai"
   

3. Use no Claude Code:

   /transcribe caminho/para/audio.mp3
   

   ou

   /transcribe https://youtube.com/watch?v=ABC123
   

Como CLI autônomo

node neurolearn.js transcrever caminho/para/video.mp4

Configuração

A skill usa as seguintes variáveis de ambiente:

• NEUROLEARN_BACKEND: Backend padrão (padrão: whisper)
• NEUROLEARN_FORMAT: Formato de saída (text, srt, vtt, json; padrão: text)
• NEUROLEARN_LANGUAGE: Código de idioma (padrão: pt)
• NEUROLEARN_MODEL: Modelo (backend específico, padrão: base para Whisper)
• Após as chaves de API listadas na tabela acima, conforme necessário.

Exemplo completo

export NEUROLEARN_BACKEND="deepgram"
export DEEPGRAM_API_KEY="dg_..."
export NEUROLEARN_FORMAT="srt"
export NEUROLEARN_LANGUAGE="en"

Uso com argumentos inline

# Backend inline
node neurolearn.js transcrever --backend groq --formato json audio.mp3

# De um vídeo do YouTube
node neurolearn.js transcrever --backend youtube "https://youtube.com/watch?v=XYZ789"

Formatos de Saída

• text: Texto simples (padrão)
• srt: Legendas SubRip (com timestamps)
• vtt: Legendas WebVTT
• json: JSON estruturado com segmentos, timestamps e confiança

Solução de Problemas

• Certifique-se de que ffmpeg está instalado para processamento de áudio local e YouTube.
• Se usar o backend Whisper local, instale whisper-cpp e coloque o binário no PATH.
• Para legendas do YouTube, o vídeo deve ter legendas automáticas disponíveis.
• As chaves de API devem ter as permissões necessárias para o serviço escolhido.

Licença

MIT