🎵 audio2text

Transcriber — Biblioteca TypeScript de código aberto, focada em transcrição de áudio para texto localmente usando o whisper.cpp sob o motor do Node.js. Sem dependências pesadas, sem mágica negra, apenas pura eficiência open-source!

🔗 Veja o nosso CHANGELOG.md para acompanhar as atualizações mais recentes.

🚀 Como Funciona

A ideia do audio2text é fornecer um wrapper leve e seguro para interagir de forma performática com a interface de linha de comando (CLI) nativa construída em cima do projeto original whisper.cpp. Em vez de re-implementar a complexidade inferencial de modelos do zero em Node, focamos em orquestrar tudo diretamente com o executável compilado do Whisper.

Ele garante que você consiga baixar modelos (models/ggml-base.bin), mapeá-los via arquivo de configuração ou chamada direta e disparar threads em C++ gerando retornos de promessas async/await em TypeScript.

import { transcribe } from "transcriber";

const result = await transcribe({
  file: "audio.wav",
  language: "pt", // Idioma pt para transcrições limpas
  threads: 4 // Ajustando CPU local
});

console.log(result.text);

🛠️ Como foi feito

Este pacote foi desenhado respeitando os princípios da Antifragilidade impostos por nossas regras globais. Trabalhando na base do @vibe2founder, a infraestrutura é agnóstica de frameworks externos complexos. Utilizamos TypeScript transpilado para criar uma ponte segura, gerenciando side-effects puros via subprocessos do Node (child_process).

• O pacote contém helpers como checkWhisperBinary() e checkModel() que interceptam o caminho garantindo a existência do binário ou modelo.
• Retorna falhas antecipadas (fail-fast), como cláusulas de guarda (Object Calisthenics), quando o binário é inexistente no seu diretório de cache ou bin/ local.

🧪 Como testar

A camada local suporta testagem imediata através de uma configuração sandbox:

1. Verifique se o binário compilado do Whisper (bin/whisper ou bin/whisper.exe) está correto.
2. Extraia e copie os modelos desejados do repositório oficial em /models.
3. Utilize os testes presentes no repositório com nosso runner customizado dentro do motor WSL (Windows Subsystem for Linux).
4. Comando para testes: bun test dentro desta pasta assegura os ciclos completos de validação, caso não exista use nossa implementação @purecore/one-proof-4-all.