docs: add macOS OpenMP workaround

This commit is contained in:
nightcityblade
2026-06-16 11:09:57 +08:00
committed by Aaron Boxer
parent ac7a9f849c
commit 471c3fd6b4
+16
View File
@@ -25,6 +25,7 @@ input from microphone and pre-recorded audio files.
- [Raw PCM Input](#raw-pcm-input)
- [Browser Extensions](#browser-extensions)
- [Whisper Live Server in Docker](#whisper-live-server-in-docker)
- [Troubleshooting](#troubleshooting)
- [Future Work](#future-work)
- [Blog Posts](#blog-posts)
- [Contact](#contact)
@@ -308,6 +309,21 @@ Refer to [`ios-client`](https://github.com/collabora/WhisperLive/tree/main/Audio
docker run -it -p 9090:9090 ghcr.io/collabora/whisperlive-cpu:latest
```
## Troubleshooting
#### macOS OpenMP runtime conflict
On macOS, especially on Intel Macs, `faster_whisper`/`ctranslate2` can conflict with OpenMP runtimes loaded by other Python packages. If the server aborts with a duplicate OpenMP runtime error, run the server with `KMP_DUPLICATE_LIB_OK=TRUE`:
```bash
KMP_DUPLICATE_LIB_OK=TRUE python3 run_server.py --port 9090 \
--backend faster_whisper \
--max_clients 4 \
--max_connection_time 600 \
--no_single_model
```
This workaround is intended for local development and testing. For production deployments, prefer using a clean environment that loads only one OpenMP runtime.
## Future Work
- [x] Add translation to other languages on top of transcription.