Repository navigation
VoiceShield v0.1.0 — Advisory Engineering Release
VoiceShield v0.1.0
VoiceShield v0.1.0 is a portfolio-grade advisory acoustic anomaly analysis engineering release for authorized local microphone streams and WAV/FLAC files.
VoiceShield does not authenticate speakers, prove identity, determine fraud, intercept cellular calls, or automatically block communications.
Supported scope
- Local development and demonstration on Apple Silicon Macs
- Authorized local microphone capture
- WAV and FLAC file analysis
- Real-time advisory acoustic anomaly scoring
- CPU and Apple MPS execution
- Official AASIST-L checkpoint loaded separately from its pinned upstream source
- Explicit insufficient-speech abstention and audio-quality diagnostics
- Volatile audio processing without intentional persistent audio storage
Validation evidence
- 494 Python tests passed
- 88.60% Python coverage
- 27 Vitest tests passed
- Mocked Playwright suite passed
- 3 live frontend/backend Playwright tests passed
- Linux CPU-only CI passed
- Security workflow passed
- Chrome and Safari manual smoke testing completed
- Official AASIST-L checkpoint integrity and provenance verified
- Real-checkpoint CPU and MPS benchmark completed on Apple M3
Verified GitHub Actions
Apple M3 real-checkpoint benchmark
The benchmark used the verified official AASIST-L checkpoint, 10 warm-up iterations, and 100 steady-state iterations per measured stage.
| Device | Model inference p50 | Model inference p95 | End-to-end p50 | End-to-end p95 | End-to-end RTF |
|---|---|---|---|---|---|
| CPU | 112.999 ms | 129.814 ms | 111.981 ms | 117.614 ms | 0.02800 |
| MPS | 30.187 ms | 30.761 ms | 33.754 ms | 34.546 ms | 0.00844 |
MPS end-to-end execution was 3.32× faster than CPU in this measured run.
A 600-second accelerated streaming stress soak completed with:
- 18,386 evaluated windows
- 0 reported dropped windows
- Maximum backlog of 1
- 0.00 MB measured RSS growth
- Bounded memory and backlog verdict: passed
Accelerated ingestion is not real-time-paced. These results are engineering latency and stability measurements, not detection-accuracy evidence.
Benchmark artifacts
Artifact SHA-256:
- Markdown:
5fc5432b220e4c5b9ed2a980948a6fa8c7de32808c1a8d8e88e8873049531438 - JSON:
73b548187230662ef487b4829cf36b3e0e6f7ee494d9937956353a7fdbd74405
Official checkpoint SHA-256:
814331d088032bb4c3fa61cc014789eadeed464209dd094ab3a2dd6ffbdce27a
Important scientific limitations
- Local ASVspoof scientific reproduction has not been completed.
- Local EER, min-tDCF, ROC-AUC, balanced accuracy, FPR/FNR, and confidence intervals remain unmeasured.
- Scores are uncalibrated acoustic anomaly scores, not probabilities.
- Operating thresholds remain unvalidated heuristics.
- No accuracy claim is made for modern generators, Indic languages, replay attacks, codecs, telephony, or noisy channels.
- VoiceShield cannot intercept cellular calls.
- VoiceShield does not automatically block calls.
- VoiceShield is not identity proof or fraud proof.
- This release is not a production-deployment or security certification.
Checkpoint and licensing boundary
Original VoiceShield code is released under Apache-2.0. Vendored AASIST source retains its MIT terms.
The AASIST-L checkpoint and evaluation datasets have separate rights and are not redistributed with this release. Obtain the checkpoint directly from the pinned upstream source and verify its SHA-256 before use.
See the repository README, model card, evaluation card, benchmark evidence, and release notes for complete setup instructions and limitations.