|
|
@@ -76,6 +76,20 @@ uv sync --extra triage
|
|
|
uv sync --extra speaker
|
|
|
```
|
|
|
|
|
|
+### AMD / ROCm hosts
|
|
|
+
|
|
|
+`uv sync` installs the CUDA CTranslate2 wheel, which loads fine on a ROCm machine but silently
|
|
|
+runs on CPU. After the last sync, install the ROCm stack:
|
|
|
+
|
|
|
+```bash
|
|
|
+scripts/install-rocm.sh
|
|
|
+```
|
|
|
+
|
|
|
+Any later `uv sync` **or plain `uv run`** (it syncs implicitly) puts the CUDA wheels back. Once the
|
|
|
+ROCm stack is in place, launch with `.venv/bin/stt-daemon ...` or `uv run --no-sync ...`, and run
|
|
|
+tests with `.venv/bin/python -m pytest`. See
|
|
|
+[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md#gpu-on-amd--rocm).
|
|
|
+
|
|
|
The `triage` extra is opt-in: the default sync does not install Laya, and the test suite stays green without it.
|
|
|
|
|
|
The `speaker` extra is likewise opt-in and **off by default**. To enable speaker identification,
|
|
|
@@ -127,7 +141,7 @@ Then launch the whole system with one command:
|
|
|
uv run stt-daemon up --with-tui
|
|
|
```
|
|
|
|
|
|
-That supervises the daemon, the assistant, and the TUI together; quitting the TUI stops everything cleanly. The manual flow is the same three steps without the supervisor:
|
|
|
+That supervises the daemon, the assistant, and the TUI together; quitting the TUI stops everything cleanly. On an AMD/ROCm host, use `.venv/bin/stt-daemon up --with-tui` instead — see [AMD / ROCm hosts](#amd--rocm-hosts). The manual flow is the same three steps without the supervisor:
|
|
|
|
|
|
```bash
|
|
|
uv run stt-daemon setup # create the virtual sink (interactive picker)
|
|
|
@@ -156,6 +170,7 @@ Run the full suite with no audio hardware or live LLM required:
|
|
|
|
|
|
```bash
|
|
|
uv run pytest -v
|
|
|
+# On an AMD/ROCm host, use `.venv/bin/python -m pytest -v` so the ROCm wheels are not reverted.
|
|
|
```
|
|
|
|
|
|
See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for what the tests cover.
|
