lumi-tantrum-pipeline 0.1.1

Reusable tantrum analysis package built around YAMNet heuristics.

tantrum-classifier

Identify tantrum segments in an audio file.

The classifier is now being extracted into a reusable package surface, lumi_tantrum_pipeline, while preserving the existing CLI workflow.

Current CLI

python classifier.py demo.wav

The CLI still supports:

• --threshold
• --gap
• --segments-dir
• --out
• --plot
• --plot-out
• --no-save

Package Contract

The reusable package lives under lumi_tantrum_pipeline and exports the router-facing contract surface through lumi_tantrum_pipeline.__init__.

Status

Initial parity and benchmark validation completed locally; broader router-side validation remains follow-up work.

Release

This package is intended to publish to PyPI via GitHub Actions Trusted Publishing.

Release flow:

1. Ensure the version in pyproject.toml is the version you want to release.
2. Create and push a matching git tag:

git tag v0.1.1
git push origin v0.1.1

3. GitHub Actions builds the distribution, verifies the tag matches pyproject.toml, and publishes to PyPI.

Repository setup required before the first release:

• In PyPI, create a Trusted Publisher for lumi-engineering/tantrum-classifier
• Workflow name: Publish PyPI Package

If you do not have access to GitHub Environments for this repository, leave the environment unset in the PyPI publisher configuration. The workflow publishes without requiring a GitHub environment.

The publish workflow lives in .github/workflows/publish-pypi.yml.