From db38085d07ce75f8961eecdc1919e98748254c53 Mon Sep 17 00:00:00 2001 From: historia Date: Fri, 28 Aug 2026 14:57:48 -0400 Subject: refactor: overhaul config.py, remove cli default options --- app/docs/backend-audiocpp.md | 2 +- app/docs/backend-faster.md | 5 ++++- app/docs/backend-qwen.md | 2 +- 3 files changed, 6 insertions(+), 3 deletions(-) (limited to 'app/docs') diff --git a/app/docs/backend-audiocpp.md b/app/docs/backend-audiocpp.md index 353fe1b..03e781e 100644 --- a/app/docs/backend-audiocpp.md +++ b/app/docs/backend-audiocpp.md @@ -83,7 +83,7 @@ In a different terminal, run `audiobook.py`. Pick the TTS `--model` and `--voice # Higgs Audio (clone-only) python audiobook.py --backend audiocpp --model Higgs-Audio-v3-TTS-4B-GGUF --voice narrator -# Qwen3-TTS built-in speaker (pick one with --voice, or omit it for config.SPEAKER) +# Qwen3-TTS built-in speaker (pick one with --voice) python audiobook.py --backend audiocpp --model Qwen3-TTS-12Hz-1.7B-CustomVoice-GGUF --voice Vivian # Qwen3-TTS voice cloning diff --git a/app/docs/backend-faster.md b/app/docs/backend-faster.md index f5b728f..5de337d 100644 --- a/app/docs/backend-faster.md +++ b/app/docs/backend-faster.md @@ -44,5 +44,8 @@ python examples/openai_server.py --voices voices.json --port 8000 Then from another terminal, run audiobook.py with `--backend faster` ```bash -python audiobook.py --backend faster [--voice NAME] +python audiobook.py --backend faster --voice NAME ``` + +`--voice` is required: NAME must be a key in the server's `voices.json` +(the server silently falls back to its first configured voice if it is not). diff --git a/app/docs/backend-qwen.md b/app/docs/backend-qwen.md index b1e1773..cb01561 100644 --- a/app/docs/backend-qwen.md +++ b/app/docs/backend-qwen.md @@ -1,6 +1,6 @@ # Backend Option 2: Qwen3-TTS -The easiest way is to run `python audiobook.py` → **Configure Backends… → Install Backend → qwen-tts** (or `python app/backends/qwen.py`): the TUI pip-installs `qwen-tts` into its own managed venv (`app/envs/qwen`, separate from the app's venv and from the faster backend's — the two TTS stacks ship conflicting versions of a shared `qwen_tts` module) — that's all there is to it, the install asks no questions. The demo port lives in `app/converter/config.py` (edit it in the hub's **Settings** screen). The qwen backend runs **one model at a time** on that single port: pick Base, CustomVoice or VoiceDesign per run on the **Generate Audiobooks** screen (the choice is remembered in `QWEN_MODEL` and re-used by the next autostart; switching models while a managed server is up restarts it with the newly-selected model). You can also start the server from the hub's **Start/Stop Backend Servers** menu, or let a conversion start it automatically. +The easiest way is to run `python audiobook.py` → **Configure Backends… → Install Backend → qwen-tts** (or `python app/backends/qwen.py`): the TUI pip-installs `qwen-tts` into its own managed venv (`app/envs/qwen`, separate from the app's venv and from the faster backend's — the two TTS stacks ship conflicting versions of a shared `qwen_tts` module) — that's all there is to it, the install asks no questions. The demo port lives in `app/converter/config.py` (edit it in the hub's **Settings** screen). The qwen backend runs **one model at a time** on that single port: pick Base, CustomVoice or VoiceDesign per run on the **Generate Audiobooks** screen (switching models while a managed server is up restarts it with the newly-selected model; an autostart boots exactly the model the run picked). You can also start the server from the hub's **Start/Stop Backend Servers** menu (a fresh start runs CustomVoice), or let a conversion start it automatically. If you prefer to install the backend yourself (in your own environment, not the managed venv), the manual steps are below. Either way the hub detects a running server by its port (its `GET /info` names which of the three demos answers), so a manually-installed backend works once its server is up. To use a demo server on another machine, set `QWEN_REMOTE_URL` in `app/converter/config.py` to its `host:port` (default `127.0.0.1:7860`) — the hub probes it and offers the matching `qwen-tts [remote]` mode limited to the model that server hosts — or pass `--api-url` on the CLI. -- cgit v1.2.3