talkbank-tools

Batchalign3는 CHAT 전사본을 생성하고 강화하기 위한 TalkBank 오디오 및 기계 학습 파이프라인입니다. 전사, 강제 정렬, 신경 형태소 태깅, 번역 및 발화 분할을 처리합니다. 이 저장소는 `batchalign3` 명령줄 도구, Python 패키지, PyO3 브리지, 대시보드 웹 UI 및 실험적 데스크톱 셸을 호스팅합니다. CHAT 형식 자체(문법, 사양, tree-sitter 파서, 데이터 모델, 검증, `chatter` CLI 및 CLAN 명령 참조)는 별도의 TalkBank `chatter` 저장소에 있습니다. 이 프로젝트는 CHAT 형식 도구 체인 자체가 아니라 chatter의 게시된 크레이트를 사용합니다. 설치는 GitHub 릴리스로만 가능하며 PyPI 패키지는 없습니다. Shell 및 PowerShell 원라이너는 설치 프로그램을 가져오며, 이 프로그램은 `uv`가 없으면 부트스트랩하고, uv 관리 Python(기본값 3.13, `BATCHALIGN3_PYTHON`으로 재정의 가능)으로 격리된 환경에 `batchalign3`를 설치하고, 다시 실행하면 업그레이드합니다. 첫 설치 시 PyTorch, Stanza, Whisper와 같은 대용량 ML 종속성을 다운로드합니다. `installers/` 아래의 `.command` 및 `.bat` 래퍼를 더블 클릭하면 동일한 설치 프로그램이 실행됩니다. 일반적인 명령으로는 `batchalign3 transcribe recordings/ -o transcripts/ --lang eng`, `batchalign3 align corpus/ -o aligned/`, `batchalign3 morphotag corpus/ -o tagged/` 등이 있습니다. 전체 CLI 참조는 mdBook에서 제공됩니다. 지원 플랫폼은 macOS(Apple Silicon 및 Intel), Linux(x86_64 및 aarch64), Windows(x86_64)이며 Python 3.13 또는 3.14입니다. 문서에는 첫 사용 시 다운로드되는 ML 모델에 수 GB의 디스크가 필요하고, 최소 8GB RAM, 권장 16GB RAM, 일부 미디어 형식에만 FFmpeg가 필요하다고 명시되어 있습니다. 문서는 `book/` 아래의 mdBook으로, 설치, 빠른 시작, Batchalign3 사용자 가이드, 아키텍처 및 개발자 지침을 다루며, `make book`으로 빌드하고 `make book-serve`로 서비스할 수 있습니다. 저장소 맵에는 `batchalign/` Python 패키지, 파이프라인용 Rust 크레이트(ASR, 강제 정렬, 형태소 태깅, 작업/러너, 저장소, 로컬 서버 제어 평면, 대시보드 API), Batchalign 특정 CHAT 변환, PyO3 브리지 및 휠 빌드 표면, 공유 유형, React 대시보드 프런트엔드, Tauri 데스크톱 셸, 설치 프로그램, mdBook 및 저장소 수준 참조 노트가 포함됩니다. CHAT 핵심 크레이트는 git-tag 종속성을 통해 공개 `chatter` 저장소에서 사용됩니다. 개발 작업은 Makefile을 통해 노출됩니다: `make check`, `make test`, `make verify`, `make batchalign-ci-rust`, `make batchalign-ci-python`, `make book`, `make ci-local`, `make ci-full`이며, `cargo run -q -p xtask -- help`를 통해 하위 수준 헬퍼를 사용할 수 있습니다. 이 프로젝트는 BSD-3-Clause 라이선스이며, 저작권은 Carnegie Mellon University에 있습니다.