Spaces:
Running
Running
| title: Ekko Tiny + PnC — Danish speech to text in your browser | |
| emoji: 🎙️ | |
| colorFrom: blue | |
| colorTo: green | |
| sdk: static | |
| app_file: index.html | |
| pinned: false | |
| short_description: On-device Danish speech recognition and punctuation | |
| # Ekko v1 Tiny browser demo | |
| This Space's code is MIT licensed. The Tiny and PnC model weights have separate | |
| terms in their Hugging Face model repositories. | |
| The [Ekko STT source code](https://github.com/Rye-A1/ekko-danish-stt) is on GitHub. | |
| This static demo transcribes Danish speech locally in the browser with Ekko v1 | |
| Tiny int8, sherpa-onnx WebAssembly, and Silero VAD. Ekko PnC loads separately | |
| and adds punctuation and capitalization without changing word timestamps. | |
| Audio and transcripts are never sent to an inference server. The most recent | |
| 20 transcript sessions are saved in the browser's local storage; audio is not | |
| saved. | |
| The model URLs and checksums are pinned in [`model-config.json`](model-config.json). | |
| The browser downloads Tiny's runtime configuration and ONNX files, then PnC's | |
| files, directly from their Hugging Face model repos. Verified model files are | |
| kept in browser storage for later visits when storage is available; every load | |
| still verifies their checksums and initializes the WebAssembly runtime. The | |
| small third-party Silero VAD file is bundled with the Space for browser access. | |
| Microphone access requires a secure origin and the browser's permission prompt, | |
| shown after the app's introductory mic dialog. Browser support remains a preview while | |
| physical-device and mobile checks are completed. | |
| The browser and Python CLI pin the same PnC v2 int8 artifact. The Python | |
| downloader also verifies the accompanying legal files from that revision. | |
| ## Local preview | |
| From the repository root, use the checksum-verified local model cache: | |
| ```bash | |
| uv sync --locked | |
| uv run --no-sync python demo/ekko-tiny-browser/serve_local.py | |
| ``` | |
| The PnC v2 files must already be in the Hugging Face cache, or pass a | |
| local directory explicitly: | |
| ```bash | |
| uv run --no-sync python demo/ekko-tiny-browser/serve_local.py \ | |
| --pnc-dir /path/to/ekko-pnc-v2 | |
| ``` | |
| The preview checks all PnC file sizes and hashes before serving them. | |
| ## Build and deploy | |
| ```bash | |
| demo/ekko-tiny-browser/build.sh | |
| ``` | |
| The build pins sherpa-onnx v1.13.6, Emscripten 4.0.23, and ONNX Runtime Web | |
| 1.29.0. It writes a static site to `demo/ekko-tiny-browser/dist/`; model | |
| weights are downloaded by the browser and are not committed. Set | |
| `EKKO_WASM_BUILDER=docker` to use the pinned container image instead of a local | |
| Emscripten installation. | |
| The GitHub workflow builds the Space for demo pull requests and pushes to | |
| `main`. On pushes to `main`, it also deploys to `RyeAI/ekko-tiny-browser` when | |
| the repository variable `HF_SPACE_DEPLOY_ENABLED` is `true`. A manual workflow | |
| run can deploy as well. Deployment requires the `HF_TOKEN` secret and | |
| anonymously accessible model URLs. The upload mirrors `dist/`, including | |
| deletions of old generated files. | |
| The JavaScript behavior checks can be run with: | |
| ```bash | |
| node tests/browser_live_chunking.mjs | |
| node tests/browser_pnc_sentence_casing.mjs | |
| node tests/browser_space_signed_assets.mjs | |
| node tests/browser_tiny_runtime_config.mjs | |
| node tests/browser_model_cache.mjs | |
| ``` | |