danceflow-stemlab 1.0.0__py3-none-any.whl

danceflow_stemlab-1.0.0.dist-info/METADATA

@@ -0,0 +1,347 @@
+Metadata-Version: 2.4
+Name: danceflow-stemlab
+Version: 1.0.0
+Summary: StemLab audio analysis for DanceFlow BPM and motion-response workflows, including WordPress DanceMoves
+Author: Kieran Simkin
+Maintainer: Kieran Simkin
+License-Expression: MIT
+Project-URL: Homepage, https://kieransimkin.co.uk/
+Project-URL: My Songs, https://kieransimkin.co.uk/my-songs/
+Project-URL: Arcadians showcase, https://kieransimkin.co.uk/arcadians/
+Project-URL: Repository, https://github.com/kieransimkin/stemlab
+Project-URL: Issues, https://github.com/kieransimkin/stemlab/issues
+Project-URL: Documentation, https://github.com/kieransimkin/stemlab/tree/main/docs
+Project-URL: Changelog, https://github.com/kieransimkin/stemlab/blob/main/CHANGELOG.md
+Project-URL: About Kieran, https://kieransimkin.co.uk/about-me/
+Project-URL: Contact, https://kieransimkin.co.uk/contact/
+Keywords: music,audio,MIR,source separation,BPM,rhythm,harmony,DanceFlow,DanceMoves,motion response,WordPress
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: torch>=2.4
+Requires-Dist: torchaudio>=2.4
+Requires-Dist: soundfile>=0.12
+Requires-Dist: matplotlib
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: librosa>=0.11
+Requires-Dist: pyloudnorm>=0.2
+Requires-Dist: cmudict>=1.1.3
+Provides-Extra: separation
+Requires-Dist: demucs>=4.0.1; extra == "separation"
+Requires-Dist: openunmix>=1.3.0; extra == "separation"
+Requires-Dist: bs-roformer-infer>=0.1.5; extra == "separation"
+Provides-Extra: speech
+Requires-Dist: faster-whisper; extra == "speech"
+Provides-Extra: beats
+Requires-Dist: beat-this>=1.1.0; extra == "beats"
+Requires-Dist: BeatNet; extra == "beats"
+Provides-Extra: deep
+Requires-Dist: sentence-transformers<7,>=6.1; extra == "deep"
+Requires-Dist: all-in-one-infer>=3.1; extra == "deep"
+Provides-Extra: semantic-nc
+Requires-Dist: muq; extra == "semantic-nc"
+Provides-Extra: amt
+Requires-Dist: basic-pitch<0.5,>=0.4; python_version < "3.12" and extra == "amt"
+Provides-Extra: server
+Requires-Dist: fastapi<1,>=0.115; extra == "server"
+Requires-Dist: uvicorn[standard]<1,>=0.34; extra == "server"
+Requires-Dist: python-socketio<6,>=5.12; extra == "server"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: tomli>=2; python_version < "3.11" and extra == "dev"
+Provides-Extra: binary
+Requires-Dist: nuitka>=2.7; extra == "binary"
+Requires-Dist: ordered-set>=4.1; extra == "binary"
+Requires-Dist: zstandard>=0.23; extra == "binary"
+Requires-Dist: lazy-loader==0.4; extra == "binary"
+Provides-Extra: all
+Requires-Dist: demucs>=4.0.1; extra == "all"
+Requires-Dist: openunmix>=1.3.0; extra == "all"
+Requires-Dist: bs-roformer-infer>=0.1.5; extra == "all"
+Requires-Dist: faster-whisper; extra == "all"
+Requires-Dist: beat-this>=1.1.0; extra == "all"
+Requires-Dist: BeatNet; extra == "all"
+Requires-Dist: sentence-transformers<7,>=6.1; extra == "all"
+Requires-Dist: all-in-one-infer>=3.1; extra == "all"
+Requires-Dist: fastapi<1,>=0.115; extra == "all"
+Requires-Dist: uvicorn[standard]<1,>=0.34; extra == "all"
+Requires-Dist: python-socketio<6,>=5.12; extra == "all"
+Dynamic: license-file
+
+# StemLab
+
+> **StemLab by [Kieran Simkin](https://kieransimkin.co.uk/)** · [My Songs](https://kieransimkin.co.uk/my-songs/) · [Arcadians EPK](https://kieransimkin.co.uk/arcadians/) · [Source](https://github.com/kieransimkin/stemlab)
+
+> **Packaging identity:** the canonical project name is **StemLab**. StemLab is part of the **Dance Flow** project. The PyPI distribution is named `danceflow-stemlab` solely because Python package-registry names are globally unique. The Python import, CLI, GitHub repository and container image remain `stemlab`.
+
+StemLab is the audio-analysis engine in Kieran Simkin's **DanceFlow** BPM and motion-response workflow. It separates and interprets a master track into synchronised stem, BPM/beat, structure, harmony, timbre, speech/lyric and semantic data. Those outputs can drive downstream motion-aware experiences, including the WordPress **DanceMoves** plugin, while StemLab remains usable as a standalone CLI, Python library, web service and container.
+
+> **Model weights are not redistributed by this project.** They are fetched from their upstream registries/releases on first use. This avoids silently republishing checkpoints whose licensing may differ from the source code license, and lets upstream integrity metadata be used where available.
+
+## DanceFlow and DanceMoves
+
+DanceFlow is the wider BPM and motion-response workflow. **StemLab** is its
+music-understanding layer; the WordPress **DanceMoves** plugin is a related
+downstream motion-response component. StemLab has no WordPress dependency and
+communicates through normal analysis artifacts and service APIs, so it remains
+independently useful and reproducible.
+
+See [docs/danceflow.md](docs/danceflow.md) for the component boundary.
+
+## Curated default model set (September 2026)
+
+| StemLab id | Role | Outputs | Why it is included |
+|---|---|---|---|
+| `bs_roformer_sw` | high-capacity | vocals, drums, bass, guitar, piano, other (+ upstream instrumental) | Current production-oriented BS-RoFormer inference package recommends this six-stem checkpoint. |
+| `mvsep_mega53` | high-capacity / broad taxonomy | 53 raw stems (discovered dynamically) | Extremely broad one-checkpoint stem inventory for later assessment. Upstream warns it is memory-heavy and recommends at least 16 GB VRAM. |
+| `scnet_xl_ihf` | high-capacity | vocals, drums, bass, other | The MSST published checkpoint table reports a 10.08 dB average MUSDB test SDR and 9.92 dB Multisong average for this model. |
+| `htdemucs_ft` | high-capacity established baseline | drums, bass, other, vocals | Fine-tuned HTDemucs remains a useful independent architecture/baseline rather than another RoFormer variant. |
+| `openunmix_umxhq` | compact / low-latency candidate | vocals, drums, bass, other | Compact PyTorch/Open-Unmix baseline. StemLab runs `niter=0` to favour latency. “Realtime” is hardware- and buffer-dependent: benchmark it on the intended target. |
+
+An optional `htdemucs_6s` model is registered for guitar/piano comparison but is not part of the default top-four group.
+
+Relevant upstreams:
+
+- https://github.com/openmirlab/bs-roformer-infer
+- https://github.com/ZFTurbo/Music-Source-Separation-Training
+- https://github.com/adefossez/demucs
+- https://github.com/sigsep/open-unmix-pytorch
+
+## Analysis performed
+
+For every successful separator, **every WAV it emits** is retained. Stem names are discovered from files rather than truncated to a hard-coded four-stem schema, which is important for MVSep Mega 53. For the master and every stem, StemLab writes both a PNG spectrogram and compressed `.npz` spectrogram data (time axis, frequency axis, dB matrix, FFT metadata).
+
+The preferred vocal stem is passed through the Silero VAD implementation bundled with `faster-whisper`. Speech regions are used to create a timeline-preserving `spoken_word.wav` (non-speech is zeroed rather than concatenated), then Whisper is run with word timestamps. Outputs include `whisper.json`, `speech_regions.json`, `transcript.txt`, `transcript.srt`, and `words.tsv`.
+
+Beat analysis runs:
+
+- **BeatNet** in offline/DBN mode.
+- **Beat This!** using the `final0` checkpoint and its minimal postprocessor.
+- **Beat Transformer**, using the original released model code/checkpoints. The model was trained on five demixed mel streams, so StemLab maps BS-RoFormer-SW to vocals, drums, bass, piano, and `other + guitar`, makes 128-bin mel-power spectrograms at the original 44.1 kHz / 4096 FFT / 1024-hop settings, and averages all eight released fold checkpoints by default. It uses the original madmom DBN decoder if madmom is importable, otherwise a documented SciPy peak-picking fallback.
+
+Beat outputs are stored as JSON, TSV, and (for Beat Transformer) activation NPZ data.
+
+StemLab also supports the official **Vamp Plugin Pack**, executed through
+**Sonic Annotator**. The curated Vamp pass focuses on musically useful outputs:
+Chordino chord transcription and harmonic-change likelihood; NNLS chroma and
+bass chroma; Queen Mary key and tonal-change detection; concert-pitch tuning;
+pYIN melody/F0 and monophonic note transcription on the preferred separated
+vocal stem; Silvet polyphonic note transcription; Segmentino song-structure
+segmentation; and the Queen Mary Vamp beat/bar tracker. Raw CSV, pinned
+transform files, JSON, NPZ and plots are retained under `vamp/`, with the most
+useful melody/harmony layers also embedded in the Sonic Visualiser session.
+
+## Comprehensive sonic, harmonic, rhythmic and semantic analysis
+
+StemLab 1.0 consolidates a higher-level evidence-fusion pass without discarding any of the
+existing low-level outputs. The default deep pass now includes:
+
+| Action | Evidence / model | Main output |
+|---|---|---|
+| Sonic profile | `pyloudnorm` BS.1770 + librosa DSP | LUFS, dynamics, true-peak estimate, timbre and stereo |
+| Groove / meter | all successful beat grids + onset analysis | tempo stability, meter, swing, offbeat energy and quantisation error |
+| Harmony | Chordino + NNLS chroma + QM key/tuning | chord progression, harmonic rhythm, key evidence and tonal changes |
+| Functional structure | All-In-One-Infer 3.1 | BPM, beats/downbeats and intro/verse/chorus/bridge/outro-style sections |
+| Rhyme / prosody | CMU Pronouncing Dictionary + timing | rhyme scheme, internal rhyme, syllables, repetitions and delivery rate |
+| Lyric semantics | SentenceTransformers | theme similarity, continuity and unsupervised line clusters |
+| Song map | StemLab evidence fusion | section-level sonic/rhythm/chord/lyric summaries on one timeline |
+
+Optional actions include **Basic Pitch** polyphonic MIDI/note transcription on isolated
+instrument stems and **MuQ-MuLan** zero-shot audio/text semantics. MuQ-MuLan's released
+weights are CC-BY-NC 4.0, so that route is deliberately opt-in and its licence is embedded
+in every result. Embedding similarities are labelled as similarities, never probabilities.
+
+Inspect the routes and their dependencies with:
+
+```bash
+stemlab analysis-actions
+```
+
+Useful switches include `--no-structure`, `--no-text-semantics`, `--audio-semantics`,
+`--basic-pitch`, and `--all-in-one-embeddings`.
+
+The derived artifacts live under `deep/` (`sonic/`, `rhythm/`, `harmony/`, `structure/`,
+`lyrics/`, `semantic_text/`, optional `semantic_audio/` and `basic_pitch/`, plus
+`song_map/song_map.json` and `summary.json`).
+
+## Install
+
+Python 3.10 or 3.11 is recommended because the legacy BeatNet/madmom ecosystem is less predictable on newer Python versions.
+
+From PyPI, install the released StemLab distribution with:
+
+```bash
+pip install danceflow-stemlab
+```
+
+The installed Python package and command remain `stemlab`. For development from a source checkout:
+
+```bash
+python -m venv .venv
+. .venv/bin/activate              # Windows: .venv\Scripts\activate
+python -m pip install -U pip
+pip install -e ".[all]"
+```
+
+SCNet and Beat Transformer are research repositories rather than stable pip inference APIs. They are isolated/downloaded on demand. To prepare everything in advance:
+
+```bash
+stemlab bootstrap all
+```
+
+For only the Vamp analysis stack:
+
+```bash
+stemlab bootstrap vamp
+```
+
+`bootstrap vamp` downloads the pinned Sonic Annotator runtime and launches the
+official Vamp Plugin Pack installer. Complete the installer once, then rerun the
+command if needed to verify that the requested plugin outputs are visible.
+
+## CLI
+
+Full requested analysis:
+
+```bash
+stemlab analyze master.wav --output ./analysis-master --profile full --device auto
+```
+
+Useful alternatives:
+
+```bash
+# Skip the 53-stem model for a materially lighter run
+stemlab analyze master.wav -o ./analysis-master --profile practical
+
+# Run only selected separators
+stemlab analyze master.wav -o ./analysis-master \
+  --model bs_roformer_sw --model scnet_xl_ihf --model openunmix_umxhq
+
+# Fail immediately rather than recording a backend failure and continuing
+stemlab analyze master.wav -o ./analysis-master --strict
+
+# Skip Vamp if the plugin pack is intentionally not installed
+stemlab analyze master.wav -o ./analysis-master --no-vamp
+
+stemlab models
+stemlab doctor
+```
+
+By default model weights and external research code are cached outside the output folder; all **generated analysis artifacts and datasets** are written inside the output folder. The copied master is also placed in `input/` so the Sonic Visualiser session is portable as one directory.
+
+## Output layout
+
+```text
+analysis-master/
+  input/master.wav
+  stems/
+    bs_roformer_sw/*.wav
+    mvsep_mega53/*.wav
+    scnet_xl_ihf/*.wav
+    htdemucs_ft/*.wav
+    openunmix_umxhq/*.wav
+  spectrograms/
+    master.png
+    master.npz
+    <model>/<stem>.png
+    <model>/<stem>.npz
+    speech/spoken_word.png
+    speech/spoken_word.npz
+  speech/
+    spoken_word.wav
+    speech_regions.json
+    whisper.json
+    transcript.txt
+    transcript.srt
+    words.tsv
+  beats/
+    beatnet.json / beatnet.tsv
+    beat_this.json / beat_this.tsv
+    beat_transformer.json / beat_transformer.tsv
+    beat_transformer_activations.npz
+  vamp/
+    report.json
+    transforms/*.n3
+    raw/*.csv
+    data/*.json
+    data/*.npz
+    plots/*.png
+  deep/
+    sonic/
+    rhythm/
+    harmony/
+    structure/
+    lyrics/
+    semantic_text/
+    song_map/
+    summary.json
+  sonic_visualiser/
+    session.sv
+    session.xml
+    open_sonic_visualiser.bat
+    open_sonic_visualiser.sh
+  analysis.json
+  manifest.json
+```
+
+`session.sv` is genuine Sonic Visualiser bzip2-compressed session XML. It contains a master pane with beat/downbeat/Whisper time-instant layers and one synchronized waveform + Sonic Visualiser spectrogram pane for every separated stem. The uncompressed `session.xml` is retained for inspection/debugging. The Windows `.bat` looks on `PATH` and in the usual Program Files locations.
+
+## Web service
+
+StemLab includes an upload/timeline web UI plus HTTP and Socket.IO APIs for
+content-addressed analysis jobs. See [docs/web.md](docs/web.md) for launchers,
+endpoints, events and the Arcadians reference workflow.
+
+## Documentation
+
+- [DanceFlow workflow and DanceMoves relationship](docs/danceflow.md)
+- [Web service](docs/web.md)
+- [Containers](docs/containers.md)
+- [Publishing and releases](docs/publishing.md)
+- [Changelog](CHANGELOG.md)
+
+## Python API
+
+```python
+from pathlib import Path
+from stemlab.models import FULL_PROFILE
+from stemlab.pipeline import run_pipeline
+from stemlab.types import PipelineConfig
+
+result = run_pipeline(PipelineConfig(
+    input_wav=Path("master.wav"),
+    output_dir=Path("analysis-master"),
+    models=FULL_PROFILE,
+    device="auto",
+))
+```
+
+## External runtime/cache details
+
+The BS-RoFormer adapter uses `bs-roformer-infer`, which manages its own checkpoint registry and SHA-256 verification. SCNet is pinned to the v1.0.15 `SCNet XL IHF` release asset URLs; StemLab records computed hashes after download. Beat Transformer is cloned from its original upstream and consumes the released fold checkpoints from that repository. Set `STEMLAB_CACHE=/some/path` to relocate StemLab's external cache.
+
+The full run is intentionally expensive. Mega-53 is the dominant VRAM/storage pass and dozens of stems mean dozens of additional spectrogram files and Sonic Visualiser panes. Use `--profile practical` while iterating and `--profile full` for exhaustive analysis.
+
+## Releases
+
+Version tags publish StemLab to GitHub Releases, PyPI (`danceflow-stemlab`),
+GHCR and Docker Hub after validation. See
+[docs/publishing.md](docs/publishing.md) for the release contract and Trusted
+Publishing setup.
+
+## Reproducibility and licensing
+
+`analysis.json` records model/backend metadata and errors; `manifest.json` hashes every output artifact. Model checkpoints, research code and datasets retain their upstream terms. In particular, do not assume that an MIT-licensed inference wrapper automatically grants redistribution rights for every checkpoint it can download.

danceflow_stemlab-1.0.0.dist-info/RECORD

@@ -0,0 +1,56 @@
+danceflow_stemlab-1.0.0.dist-info/licenses/LICENSE,sha256=LPD2FFuqoDfCWcmG8_wrcFOzf9uun0jOyYdREcl8ArA,1077
+stemlab/__init__.py,sha256=8GvZqf9_9prjePHZvvq9BX7LJ359uP1gwxQ73d4GdSY,359
+stemlab/__main__.py,sha256=Qd-f8z2Q2vpiEP2x6PBFsJrpACWDVxFKQk820MhFmHo,59
+stemlab/audio.py,sha256=jfHp0YnmNaULC5tBN_KLNt64q2Mp7ujn6dydcqevp7U,5960
+stemlab/bootstrap.py,sha256=LNFECUFYGQHbVQkngwksII30HOaI1MhrmfysyZbUfvk,5054
+stemlab/branding.py,sha256=W0z2xpNcPJceu36rsZjCGaKW7dY_bxZcgNauQQ4Xpo4,1958
+stemlab/canonical.py,sha256=Q9777m72_dXwDNtgRPH4wy3ngWtKGTdZY8w_H1j6Bxc,6829
+stemlab/cli.py,sha256=MFa1lKXq97nNciWq0yD3_Ty__NKaqcytjRMAlbJjHfU,9324
+stemlab/manifest.py,sha256=-zy8aUEGsOGIv7fcdvdatgzL0pRVBWJr-fEMoWiVQps,903
+stemlab/models.py,sha256=Sph8omyF59i-_NthsH0Rj-8RAfwrgXBqxwSnty2K770,4169
+stemlab/pipeline.py,sha256=Sg35vG_A7-Reyao9qvnQ8rDwciApUYOKBJjM_9EPm5I,16446
+stemlab/server.py,sha256=sRiXpdLjhTplET-s4A-6Ubpo01DK1EaZALIARIRMVWk,37233
+stemlab/sonic_visualiser.py,sha256=ogVOKO0swyhyZ2lZKiUHtjv_eSVSBJtjSL1hlIviK5s,41796
+stemlab/spectrogram.py,sha256=XuXWRfMa1fvIYUxiTwML8HSgw0LPV7OY1hER7driQnU,2602
+stemlab/speech.py,sha256=zM7wfsfQsDqdy10L1KX7boVrRYaCNF1nSHFWlNbztR8,4416
+stemlab/types.py,sha256=WzYK_mO10jMKVXLzBXApqaPWD_J2a18gLNVXeJNCoX8,1912
+stemlab/util.py,sha256=nTltGBhzSRapUqnthW-SC97VZL-is6_zgCF7_mIFsy0,1556
+stemlab/vamp.py,sha256=CKBVRLXJpgKtJ41xAg7gGKlaqOtO10nIkXP9gCCaGOk,12064
+stemlab/vamp_runtime.py,sha256=_pwRccBYisfj5iYVG3a5EtOoUuRUzksXV8x7KFVFcYs,9181
+stemlab/webui.py,sha256=5wLtKqBQno_hqZGV-g9cmqv02p6BcXi8udHlGgB5XAg,14984
+stemlab/analysis/__init__.py,sha256=61X0tC9vFNaZzHT-cmH33PWaylDvjOsLzdA2akLH_q8,169
+stemlab/analysis/harmony.py,sha256=Y8y59h8tAgjt_-Xy48q2aKs-rU038BRY5AB5N8yT7Lo,14232
+stemlab/analysis/lyrics.py,sha256=-kf-6_YxCtHCQPV1DZkViDNhPb98VPXVd5R5B7kpVhQ,11009
+stemlab/analysis/registry.py,sha256=4s2Kv9WoFFn26WKqGSmKiP9xZ42S5KnANIHEPxV83bY,4117
+stemlab/analysis/rhythm.py,sha256=XmnP1kGorBwLEYnXp50jEr6DAlu3M-1yJ0HhquIHpWw,8768
+stemlab/analysis/runner.py,sha256=df21UI4E_od_Ci7DKogb5p07edag-fZV8DII4Iw4ANM,6414
+stemlab/analysis/semantic_audio.py,sha256=N6kopNv8AjZBYJ2P9EbXg2MgHiDd9bkBcE4aNKs9Gpo,4024
+stemlab/analysis/semantic_text.py,sha256=gdzXaGOPikqNpNI-PfwcdCsw3GLs7vqVKlYQZe1iiX0,4383
+stemlab/analysis/song_map.py,sha256=KYuy-7BqXQBn-p2-9TOZJQoDKUtAohUC4iL68RsT3qg,9115
+stemlab/analysis/sonic.py,sha256=ok-ZaHTcdOYoCNbVklHnN-vEHEx12etCcuDKy5b2C3Q,7416
+stemlab/analysis/structure.py,sha256=WQ1UauNoWbnpdrXibzIaJX9tDMCzIzh-w5KIHj7Xzp0,3742
+stemlab/analysis/transcription.py,sha256=2RC45SQlXxhGJ3flcbYy9zjX917Sp-KsXCVCxSDXvvc,3823
+stemlab/beats/__init__.py,sha256=iiwERMYfDQwaLRVxk-yR_iGRCo88ovjzLvAvFeKiXpM,201
+stemlab/beats/base.py,sha256=5YHcr3MVcwBCwVoGAXhpLQS-lgClYXSrHJNIKDfnT7E,343
+stemlab/beats/beatnet.py,sha256=i4Cds2QgsERBpUwzZoat2I1_OSn--ZPyz__PBhiPXw8,3347
+stemlab/beats/beatthis.py,sha256=pKeOSScWG5SjFcWQLvdhxe5gWAtL5_zunQEEhWEU6jA,890
+stemlab/beats/beattransformer.py,sha256=zwK2Yd5YRWqa3zDxF3m1JF1pZMyBYmnKsKZq4SvnZBA,7151
+stemlab/beats/common.py,sha256=HdnyIsEgrfYK2Vqa5hnhLyyAWeprw5Kgpvwx6jsrHl8,4362
+stemlab/separators/__init__.py,sha256=GoMjT0Au-KPM06QKa_tHi4qnmUGDlgOJKAFVRZBhBgM,547
+stemlab/separators/base.py,sha256=Q1cHraGSJnU5zJwVVBoxSQke3orbOFi4FskMyNt2CH0,335
+stemlab/separators/bsroformer.py,sha256=NO6xaMdDDqhV9DssbATlnDP3c-lUpCICP7W5xwm80cE,2903
+stemlab/separators/common.py,sha256=nsPszsO-w-_HFaHa0g-j_ATa9iKrzmvujxTtehumbUk,1114
+stemlab/separators/demucs.py,sha256=yHI3EvKO6xZUaqcfgdzRwatfYLNufdbBsE434IMQZ9Y,2085
+stemlab/separators/openunmix.py,sha256=tJXHkT7Nx0KiJGLdaZ7qr19XkYyec-MS4QM5y5D6tJw,1878
+stemlab/separators/scnet.py,sha256=l8SuhOkWLe8nldxN0DxkO_H5SWxFfn2gHw6z0nV-9JY,2474
+stemlab/web/app.js,sha256=HgFba_DqEryw2Il8y3jvtX5oNiR2MySgzq2IDCW8NVk,33832
+stemlab/web/arcadians-cover.jpg,sha256=i_7_k5wf_Lp1KWFCY-BdTxu1mkbmwTUB2_EjSe2wR-4,745386
+stemlab/web/arcadians-reference.json,sha256=wJz5PXQ9eFGVZrMi-ST6QJlaorEIz_HXJ7uCm4lvD2o,8601
+stemlab/web/canonical.js,sha256=jKPGAZrmsbvmwMY286GFZcqfAACidZRrYKw1lxeeCfE,14417
+stemlab/web/index.html,sha256=kBwqJq47y_nb9mCpBkQNmc8Ch--yuVCrgWi9cU9B6Xs,7268
+stemlab/web/style.css,sha256=2ARj4QWCoRosKiPlJ0wIWCSjTeC2sKNAYxloZp96KRw,15166
+danceflow_stemlab-1.0.0.dist-info/METADATA,sha256=-gkG6WbS8bkX0D70ehT6fx993ooKuZmihzvS-nocPU4,16509
+danceflow_stemlab-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+danceflow_stemlab-1.0.0.dist-info/entry_points.txt,sha256=rVHBHWZPCVoH5bw3D82bRHx_U0TY26XYo36qchl6Kvg,44
+danceflow_stemlab-1.0.0.dist-info/top_level.txt,sha256=pT2NYpLC01yTrISYKKr0uoXJjOX32J9sX4X1MrYeYg4,8
+danceflow_stemlab-1.0.0.dist-info/RECORD,,

danceflow_stemlab-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

danceflow_stemlab-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+stemlab = stemlab.cli:app

danceflow_stemlab-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StemLab contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

danceflow_stemlab-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+stemlab

stemlab/__init__.py

@@ -0,0 +1,10 @@
+"""StemLab — audio analysis for the DanceFlow BPM and motion-response workflow.
+
+StemLab is the canonical project name. The PyPI distribution is
+``danceflow-stemlab``; the Python package and CLI remain ``stemlab``.
+
+Created by Kieran Simkin — https://kieransimkin.co.uk/
+Music catalogue — https://kieransimkin.co.uk/my-songs/
+"""
+
+__version__ = "1.0.0"

stemlab/__main__.py

@@ -0,0 +1,4 @@
+from .cli import app
+
+if __name__ == "__main__":
+    app()

stemlab/analysis/__init__.py

@@ -0,0 +1,5 @@
+"""High-level musical analysis built on StemLab's existing evidence layers."""
+
+from .runner import run_comprehensive_analysis
+
+__all__ = ["run_comprehensive_analysis"]