Requirements:
- docker, or podman installed
- 50gb disk free
- 2gb ram free
how to use, for wake word “hey eyeball”
- Clone or download the repo as a .zip file
- go to the directory
- run dockebuild . -t wakeword
- run docker r run -it --rm -p 8080:8080 wakeword -c “hey eyeball”
In my testing it takes about 6-7 minutes to build the container and 20-25 minutes to generate the wakeword on a 12th gen intel i5.
Notes: this uses cpu mode, which is slower, but compatible with 95%+ of cpus out there, so no gpu is needed. 25 minutes in cpu mode is worth the tradeoff for wider compatibility
CPU mode uses some newer cpu instructions so if you’re running this in a vm you might need to run the vm in “host mode” or manually enable them (I think it needs ARV or ARF or something I forget, hostmode in proxmox fixed it though)
Why I did this: I hate jupiter notebooks and google collab, there’s a steep learning curve there there’s no reason to hide it behind a third party when most people know how to use containers in 2025 and this isn’t that big of a job you need a gpu
Final notes: the final log lines tell you how to download the file from the container (since docker copy is slightly complex) the log output looks something like this
INFO:absl:Cutoff 0.04: frr=0.0000; faph=1.687
INFO:absl:Cutoff 0.04: frr=0.0000; faph=2.000
2025-11-07T11:05:01Z INFO still training…
2025-11-07T11:05:05Z INFO training complete for ‘hey eyeball’; download at http://0.0.0.0:8080/hey_eyeball.tflite (took 0:21:04)
2025-11-07T11:05:05Z INFO serving trained models from /workspace/hey_eyeball/serve; press Ctrl+C to stop
You can either plug http://0.0.0.0:8080/hey_eyeball.tflite into your favorite browser, or run curl -O http://0.0.0.0:8080/hey_eyeball.tflite
If you are feeling fancy you can use docker copy to grab it from /workspace/hey_eyeball/serve/hey_eyeball.tflite
Cheers and goodluck