80d8fb4d7e
Same reasoning as the lab renders: the WAVs are copies of files that live in ~/Documents/Audacity4/ and are mirrored at ~/.umbra/library/author_voice_matrix/20261009T191636Z/. Git does not need a third copy to be safe. What stays is the part that is not duplicated anywhere else in a form git can restore: author_v2.pt and author_v1.pt, 62 KB, the actual voice identity. manifest.json keeps a SHA-256 for each WAV, so any copy can be verified against what was captured rather than trusted. RESTORE.md was wrong after this change and is fixed. It listed the WAVs as files of the backup and told you to `cp BDMurphy_Voice_NOBG_v2.wav` from that directory, which no longer works. It now states the WAVs are untracked and where they actually are, and adds the verified matrix->WAV decode as a first-class restore path, because that is the point: the WAV is derived from the matrix, not a prerequisite for it. Note the asymmetry this leaves in place, deliberately. Loss of the matrix means losing the captured voice, and no WAV in existence could reconstruct the exact one. Loss of the WAVs costs nothing, because they can be rebuilt from the matrix. So the durable, unreproducible artifact is the thing that stays tracked.
UmbraAudio
Quality-first multi-pass audiobook generation from English manuscripts.
Features
- 5-pass pipeline: Analysis → Voice Design → Mapping → Test → Generate
- Multi-engine TTS: Chatterbox (primary), Qwen3-TTS (secondary)
- LLM-enhanced: BookNLP for NLP, LLM for profiling/emotion/pronunciation
- Web review: FastAPI + HTMX at checkpoints for human approval
Quick Start
python -m umbraaudio.cli init <manuscript.epub> --name 'My Book'
python -m umbraaudio.cli analyze
python -m umbraaudio.cli voices
python -m umbraaudio.cli review
Requirements
- Python 3.11+
- NVIDIA GPU with CUDA support (RTX 3060 or better recommended)
- ffmpeg
Development
pip install -e ".[dev]"
ruff check umbraaudio/
pytest tests/ -v
Commit cadence: commit at least once every Sunday. Never leave a week (let alone a month) of work uncommitted — a single accidental
git checkouton 2026-09-20 wiped out a month of changes toumbraaudio/web/routes.py. SeeAGENTS.md→ Commit Cadence.
scripts/commit_check.sh enforces the nudge: it exits non-zero once the tree has been dirty
longer than a week. The LaunchAgent com.umbraaudio.commitcheck runs it every Sunday at
18:00 and posts a macOS notification when there is uncommitted work.
scripts/commit_check.sh # warn if dirty > 7 days
scripts/commit_check.sh --days 3 # tighter threshold
scripts/commit_check.sh --any # warn on any uncommitted change
Rebuilding from source
The repo tracks source only; large runtime data is reconstructed as needed.
-
Models: weights are not committed (see
.gitignore). Download them:bash scripts/download_models.sh # ~9 GB, targets ./models -
Qwen3-TTS is a git submodule pinned to upstream commit
022e286:git submodule update --init --recursiveThe
tts_server/web-demo backend includes a local UI customization toqwen_tts/cli/demo.py. It is preserved as a patch — reapply it after checking out the submodule:cd Qwen3-TTS && git apply ../scripts/qwen3_tts_demo_umbra_patch.patch -
Environment: copy/keep
.env(contains secrets) and setUMBRA_TTS__*model paths undermodels/.
Book projects (e.g. DealHunterShip_...) are committed separately under their
own project directories and are not part of this program repository.