Skip to content

ttucs v0.2.0

Choose a tag to compare

@SoundsLikeJonny SoundsLikeJonny released this 08 Nov 21:39
· 34 commits to main since this release
d8ca5e6

Added

  • Pretrained weights ship as the data-only ttucs-model-bow 0.1.1 distribution (fp16 safetensors, SHA-256
    manifest, 131,072 x 128 compact model from configs/bow-release.yaml). It is a default dependency,
    so pip install ttucs works offline right after install. It is versioned separately from ttucs.
  • ttucs.hub: offline-first model resolution (explicit path, installed package, local cache in
    TTUCS_HOME or the platform cache dir, then a SHA-256-verified GitHub Release download).
    TTUCS_OFFLINE=1 or HF_HUB_OFFLINE=1 disables all network access.
  • CLI ttucs info [--verify] and ttucs download [--url --sha256 --force].
  • Model loading from weights.safetensors (fp16 or fp32) as well as weights.pt; training records
    its data sources in config.json.
  • scripts/build_model_package.py (reproducible weights tarball and wheel), trusted-publishing
    workflow .github/workflows/publish.yml, and docs/RELEASING.md.

Changed

  • CI workflows moved from ci/ to .github/workflows/ (ci.yml, publish.yml), so GitHub runs them.
  • Lean core install: scikit-learn, pandas, matplotlib and MLflow moved to the [train] extra.
    train, eval and report print an install hint without it.
  • TTUCS.from_pretrained() with no arguments now loads the installed ttucs-model-bow weights.
  • The default model is now the compact model trained on redistributable data only. Accuracy on the 80
    hand-written evaluation slates drops from 0.713 to 0.488 top-1 (0.913 to 0.813 top-5); synthetic
    test sets stay at about 0.86-0.87 top-1.
  • README rewritten for PyPI with absolute links; model and data cards updated for the published model.

Removed

  • Breaking: third-party sound library metadata ingestion and its CLI fetch command. The published
    weights are trained only on synthetic data and the UCS list.

Fixed

  • License metadata uses an SPDX expression (license = "MIT", license-files) instead of the
    deprecated TOML table and license classifier.