talkbank-tools

Batchalign3 é a pipeline de áudio e aprendizado de máquina do TalkBank para criar e enriquecer transcritos CHAT. Ele lida com transcrição, alinhamento forçado, morfotagging neural, tradução e segmentação de expressões. O repositório hospeda a ferramenta de linha de comando `batchalign3`, seu pacote Python, uma ponte PyO3, uma interface web de painel e um shell de área de trabalho experimental. O formato CHAT em si — gramática, especificação, analisador tree-sitter, modelo de dados, validação, a ferramenta de linha de comando `chatter` e a referência de comando CLAN — vive no repositório `chatter` do TalkBank separado. Este projeto consome as crates publicadas do chatter em vez de ser uma cadeia de ferramentas de formato CHAT em si. A instalação é feita apenas por meio de lançamentos do GitHub; não há pacote PyPI. Shell e PowerShell em uma linha baixam um instalador que inicializa `uv` se ausente, instala `batchalign3` em um ambiente isolado com um Python gerenciado por uv (3.13 por padrão, substituível via `BATCHALIGN3_PYTHON`) e atualiza na reexecução. A primeira instalação baixa grandes dependências de ML, como PyTorch, Stanza e Whisper. Os wrappers `.command` e `.bat` em `installers/` executam o mesmo instalador. Comandos típicos incluem `batchalign3 transcribe recordings/ -o transcripts/ --lang eng`, `batchalign3 align corpus/ -o aligned/` e `batchalign3 morphotag corpus/ -o tagged/`. Uma referência completa da CLI é fornecida no mdBook. As plataformas suportadas são macOS (Apple Silicon e Intel), Linux (x86_64 e aarch64) e Windows (x86_64), com Python 3.13 ou 3.14. A documentação observa vários GB de disco para modelos de ML baixados na primeira utilização, 8 GB de RAM mínimo e 16 GB recomendado, e FFmpeg necessário apenas para alguns formatos de mídia. A documentação é um mdBook em `book/`, cobrindo instalação, início rápido, o guia do usuário do Batchalign3, arquitetura e orientação para desenvolvedores, construída com `make book` e servida com `make book-serve`. O mapa do repositório inclui o pacote Python `batchalign/`, crates Rust para a pipeline (ASR, alinhamento forçado, morfotagging, jobs/runner, store, plano de controle do servidor local, API do painel), transformações CHAT específicas do Batchalign, a ponte PyO3 e a superfície de construção da roda, tipos compartilhados, uma interface de usuário de painel React, um shell de área de trabalho Tauri, instaladores, o mdBook e notas de referência de nível de repositório. As crates core CHAT são consumidas do repositório `chatter` público por meio de dependências de tag git. Tarefas de desenvolvimento são expostas por meio de um Makefile: `make check`, `make test`, `make verify`, `make batchalign-ci-rust`, `make batchalign-ci-python`, `make book`, `make ci-local` e `make ci-full`, com ajudantes de nível inferior via `cargo run -q -p xtask -- help`. O projeto é licenciado BSD-3-Clause, copyright Carnegie Mellon University.