65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# Overview
|
|
- A lightweight, up to date speech recognizer in the browser with total brotlied (used by JSDelivr) size of **under a megabyte** (609 KB)
|
|
- Live Demo (ASR in 20 languages): https://msqr1-github-io.pages.dev/Vosklet
|
|
- Inspired by [vosk-browser](https://github.com/ccoreilly/vosk-browser)
|
|
|
|
# Documentation
|
|
- See [Documentation.md](Documentation.md)
|
|
|
|
# Vosklet ...
|
|
- Is regularly maintained
|
|
- Support multiple models
|
|
- Include model cache path management
|
|
- Include model cache ID management (for updates)
|
|
- Wraps all Vosk's functionaly
|
|
|
|
# Basic usage (microphone recognition in English)
|
|
- Using JsDelivr CDN
|
|
- Result are logged to the console
|
|
- Copied from [Examples/fromMic.html](Examples/fromMic.html)
|
|
- **IMPORTANT:** Please see [Examples/README.md](Examples/README.md)
|
|
```html
|
|
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<script src="https://cdn.jsdelivr.net/gh/msqr1/Vosklet@1.2.0/Examples/Vosklet.js" async defer></script>
|
|
<script>
|
|
async function start() {
|
|
// All data is collected and transfered to the main thread so the AudioContext won't output anything. Set sinkId type to none to save power
|
|
let ctx = new AudioContext({sinkId: {type: "none"}});
|
|
|
|
// Setup microphone
|
|
let micNode = ctx.createMediaStreamSource(await navigator.mediaDevices.getUserMedia({
|
|
video: false,
|
|
audio: {
|
|
echoCancellation: true,
|
|
noiseSuppression: true,
|
|
channelCount: 1
|
|
},
|
|
}));
|
|
|
|
// Load Vosklet module, model and recognizer
|
|
let module = await loadVosklet();
|
|
let model = await module.createModel("https://ccoreilly.github.io/vosk-browser/models/vosk-model-small-en-us-0.15.tar.gz","English","vosk-model-small-en-us-0.15")
|
|
let recognizer = await module.createRecognizer(model, ctx.sampleRate);
|
|
|
|
// Listen for result and partial result
|
|
recognizer.addEventListener("result", ev => console.log("Result: ", ev.detail))
|
|
recognizer.addEventListener("partialResult", ev => console.log("Partial result: ", ev.detail));
|
|
|
|
// Create a transferer node to get audio data on the main thread
|
|
let transferer = await module.createTransferer(ctx, 128 * 150);
|
|
|
|
// Recognize data on arrival
|
|
transferer.port.onmessage = ev => recognizer.acceptWaveform(ev.data);
|
|
|
|
// Connect transferer to microphone
|
|
micNode.connect(transferer);
|
|
}
|
|
</script>
|
|
<!-- Start and create audio context only as a result of user's action -->
|
|
<button onclick="start()">Start</button>
|
|
</head>
|
|
</html>
|
|
```
|