Spaces:
Sleeping
Sleeping
|
Download docs/ARCHITECTURE.md from space-cadet/ser-inference: direct link, hf CLI and curl.
- Browser
- Download file 7.58 kB
-
https://huggingface.co/spaces/space-cadet/ser-inference/resolve/main/docs/ARCHITECTURE.md
- Command line
-
hf download hf://spaces/space-cadet/ser-inference/docs/ARCHITECTURE.md
-
curl -L -o ARCHITECTURE.md https://huggingface.co/spaces/space-cadet/ser-inference/resolve/main/docs/ARCHITECTURE.md
7.58 kB
Architecture
Request flow (POST /predict)
βββββββββββββββββββββββββββ
audio file, session_id, β FastAPI /predict β
consent flag βββββββββΊ β (app/api/routes.py) β
ββββββββββββββ¬ββββββββββββββ
β
ββββββββββββββΌββββββββββββββ
β Canary routing β Track 3.2
β (app/routing/canary.py) β champion or challenger
ββββββββββββββ¬ββββββββββββββ
β
ββββββββββββββΌββββββββββββββ
β decode + resample β app/audio/decode.py
β (PyAV, any codec β 16k mono)β
ββββββββββββββ¬ββββββββββββββ
β
ββββββββββββββΌββββββββββββββ
β validation gate β Track 2.1
β duration / RMS silence floor β app/audio/validate.py
ββββββββββββββ¬ββββββββββββββ
rejectβ pass
βββββββββββββββββ β
β βΌ
β βββββββββββββββββββββββββββ
β β VAD trim (silero) β Track 2.1
β β app/audio/vad.py β
β ββββββββββββββ¬ββββββββββββββ
β β
β ββββββββββββββΌββββββββββββββ
β β WavLM + pooling + MLP β app/inference/predict.py
β β classifier forward pass β (run_inference)
β ββββββββββββββ¬ββββββββββββββ
β β
β ββββββββββββββΌββββββββββββββ
β β calibration (Platt/isotonic)β Track 1.2
β β app/calibration/calibrate.pyβ
β ββββββββββββββ¬ββββββββββββββ
β β
β ββββββββββββββΌββββββββββββββ
β β confidence cascade β Track 1.3
β β app/inference/cascade.py β
β ββββββββββββββ¬ββββββββββββββ
β β
βΌ βΌ
response_emotion=neutral response_emotion=<label or neutral>
(chat-safe default) cascade_tier attached
β β
β ββββββββββββββΌββββββββββββββ
β β session state update β Track 3.3
β β app/session/state.py β
β ββββββββββββββ¬ββββββββββββββ
β β
ββββββββΊβββββββββββββΌββββββββββββββ
β consent check β Track 2.4
β app/logging_pipeline/consent β
ββββββββββββββ¬ββββββββββββββ
can_log β can't log
βΌ β
ββββββββββββββββββββββββ
β feature/drift log ββ Track 2.2/2.3
β SQLite or HF Dataset ββ
βββββββββββββββ¬ββββββββββ
ββββββββββββ
βΌ
JSON response to caller
Offline / scheduled paths (not on the request critical path)
scripts/calibration_fit.py βββΊ data/calibration/calibration.json βββΊ loaded at app startup
scripts/build_drift_reference.py βββΊ data/drift_reference/train_features.json
.github/workflows/drift-check.yml (cron) βββΊ scripts/drift_check.py
reads live features from feature log, compares to reference via ks_2samp,
fires app/alerts/webhook.py on drift or high low-confidence rate
scripts/champion_challenger_eval.py βββΊ promotion recommendation across all corpora
.github/workflows/ci-eval-gate.yml βββΊ tests + eval gate on every merge to main
Component responsibilities
app/model/β loading and sanity-checking checkpoints from HF Hub revisions.registry.pyis the seam where a self-hosted MLflow instance could replace "the Hub repo is my registry" later without touching anything else.app/audio/β everything that happens to a clip before it reaches the model. Fail-safe by design: VAD fails open (scores raw audio if unavailable rather than crashing), validation fails closed (rejects and returns neutral rather than scoring garbage).app/calibration/+app/inference/β the actual modeling-rigor layer. Calibration is a pure function of an offline-fit JSON file; the cascade is pure logic with no I/O β both are unit-testable without a model.app/session/β the one piece of state that spans requests. Kept behind aSessionStoreinterface specifically so swapping memory β Redis is a config change, not a rewrite.app/logging_pipeline/β the data flywheel.consent.pysits in front of everything else in this package on purpose β nothing else in the package should be reachable from the request path without going through it first.app/routing/β single-purpose: pick champion or challenger. Kept separate frompredict.pyso the canary logic can be tested/changed without touching the inference pipeline.app/alerts/β intentionally the simplest module in the repo. Two lines of actual logic. Resist the urge to grow it in place β an on-call paging system is a different tool, not a bigger webhook module.