File size: 1,636 Bytes
2ee248a
 
 
 
 
e03b5a6
2ee248a
2361fbc
2ee248a
 
 
 
 
 
 
 
 
0db3249
 
 
 
 
 
 
 
2ee248a
0db3249
 
 
2ee248a
c6a619d
2ee248a
 
c6a619d
4a1f367
 
 
 
 
 
 
 
 
 
c6a619d
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# command.wasm

This is a basic Voice Assistant example that accepts voice commands from the microphone.
It runs in fully in the browser via WebAseembly.

Online demo: https://ggml.ai/whisper.cpp/command.wasm/

Terminal version: [examples/command](/examples/command)

## Build instructions

```bash
# build using Emscripten (v3.1.2)
git clone https://github.com/ggerganov/whisper.cpp
cd whisper.cpp
mkdir build-em && cd build-em
emcmake cmake ..
make -j libcommand
```
The example can then be started by running a local HTTP server:
```console
python3 examples/server.py
```
And then opening a browser to the following URL:
http://localhost:8000/command.wasm/

To run the example in a different server, you need to copy the following files
to the server's HTTP path:
```
cp bin/command.wasm/*       /path/to/html/
cp bin/libcommand.js        /path/to/html/
cp bin/libcommand.worker.js /path/to/html/
```

> πŸ“ **Note:** By default this example is built with `WHISPER_WASM_SINGLE_FILE=ON`
> which means that that a separate .wasm file will not be generated. Instead, the
> WASM module is embedded in the main JS file as a base64 encoded string. To
> generate a separate .wasm file, you need to disable this option by passing
> `-DWHISPER_WASM_SINGLE_FILE=OFF`:
> ```console
> emcmake cmake .. -DWHISPER_WASM_SINGLE_FILE=OFF
> ```
> This will generate a `libcommand.wasm` file in the build/bin directory.

> πŸ“ **Note:** As of Emscripten 3.1.58 (April 2024), separate worker.js files are no
> longer generated and the worker is embedded in the main JS file. So the worker
> file will not be geneated for versions later than `3.1.58`.