Upload README.md with huggingface_hub
Browse files
README.md
CHANGED
|
@@ -25,7 +25,7 @@ A speech-to-text model for mobiles, wearables, robots, smart home, automotive an
|
|
| 25 |
|
| 26 |
Whistle does three jobs, all of them on the device:
|
| 27 |
|
| 28 |
-
- **Transcription**: 16 kHz mono audio, up to 30 seconds
|
| 29 |
- **Word timestamps**: every word with its start, end and probability, aligned from the decoder's own attention, so an app can highlight, seek or cut on a word.
|
| 30 |
- **Speech embedding**: the encoder output, one row per 80 ms frame, for matching and retrieval without decoding a transcript at all.
|
| 31 |
|
|
@@ -90,9 +90,10 @@ The engine and its platform folders live in [Cactus-Compute/needle3](https://hug
|
|
| 90 |
needle download macos-arm64
|
| 91 |
needle download whistle
|
| 92 |
./macos-arm64/needle --model whistle.cact --audio clip.wav --audio-word-timestamps
|
|
|
|
| 93 |
```
|
| 94 |
|
| 95 |
-
`needle_load`, `needle_transcribe` and `needle_embed` are the whole speech C API, declared in `needle.h` beside Needle's own, and `needle_complete` takes the clip directly and does the transcription for you. The engine reads no environment variables: every behaviour is a compiled default or an explicit flag, so every run of the same blob scores the same.
|
| 96 |
|
| 97 |
The [devices guide](https://cactuscompute.com/blog/needle-supported-devices) covers the runner flags, the C API, the WASI component and air-gapped setup.
|
| 98 |
|
|
|
|
| 25 |
|
| 26 |
Whistle does three jobs, all of them on the device:
|
| 27 |
|
| 28 |
+
- **Transcription**: 16 kHz mono audio of any length, one pass up to 30 seconds and windowed beyond it, in English, German, French, Spanish, Italian, Dutch and Polish. The language is detected unless you name it, and silence returns an empty transcript rather than an invented sentence. Live audio streams for as long as you like, committing the words two passes agree on.
|
| 29 |
- **Word timestamps**: every word with its start, end and probability, aligned from the decoder's own attention, so an app can highlight, seek or cut on a word.
|
| 30 |
- **Speech embedding**: the encoder output, one row per 80 ms frame, for matching and retrieval without decoding a transcript at all.
|
| 31 |
|
|
|
|
| 90 |
needle download macos-arm64
|
| 91 |
needle download whistle
|
| 92 |
./macos-arm64/needle --model whistle.cact --audio clip.wav --audio-word-timestamps
|
| 93 |
+
./macos-arm64/needle --model whistle.cact --audio talk.wav --audio-stream
|
| 94 |
```
|
| 95 |
|
| 96 |
+
`needle_load`, `needle_transcribe`, `needle_stream_transcribe_process`, `needle_stream_transcribe_stop` and `needle_embed` are the whole speech C API, declared in `needle.h` beside Needle's own, and `needle_complete` takes the clip directly and does the transcription for you. The engine reads no environment variables: every behaviour is a compiled default or an explicit flag, so every run of the same blob scores the same.
|
| 97 |
|
| 98 |
The [devices guide](https://cactuscompute.com/blog/needle-supported-devices) covers the runner flags, the C API, the WASI component and air-gapped setup.
|
| 99 |
|