Files
3376228d4b fix: repair Linux installs and README commands that fail on a clean machine (#742)
* fix: repair Linux installs and README commands that fail on a clean machine

Verified on a Linux GPU box using a fresh .venv and a separate UV_CACHE_DIR,
since a warm cache hides every one of these.

pyproject.toml:

- triton-windows had no platform marker, so `uv sync --extra accel` (or
  --all-extras) aborted on Linux: the package only publishes win_amd64 wheels.
  Linux already gets `triton` as a torch dependency.
- Replace `no-build-isolation-package` with `extra-build-dependencies`. That
  mode uses `.venv` itself as the build environment, and a fresh `.venv` has no
  setuptools yet, so deepspeed failed with `ModuleNotFoundError: No module
  named 'setuptools'` on any clean machine. Injecting torch with
  `match-runtime` keeps the CUDA-enabled build inputs while leaving isolation
  (and its setuptools) in place. It also lets flash-attn resolve a prebuilt
  wheel from its own torch version and C++ ABI flag instead of invoking nvcc.

README (and the zh/ja/es/ar translations):

- `examples/09.wav` does not exist in the demo space and is not in
  cases.jsonl; the on-demand download fetches `voice_09.wav`.
- `huggingface-hub` dropped its `cli` extra, so the install line warned.
- Example audio is fetched by the WebUI only, not by `infer_v2_5.py`, whose
  default --prompt_wav is `examples/voice_01.wav`. Say so and give a one-liner
  to fetch it.
- Drop `uv run indextts/infer_v2.py`: it is a benchmark loop hardcoded to
  `checkpoints/`, so with the documented `checkpoints_2` layout it dies on
  `vocab_file checkpoints/bpe.model does not exist`.
- `use_emo_text=True` needs `use_qwen_emo=True` at construction, which the
  init example omits.

webui.py: title and arXiv badge were hardcoded to IndexTTS2, so the 2.5 UI
announced itself as 2 and linked the 2.0 paper.

* docs: install huggingface-hub without extras

`hf-xet` is an unconditional base dependency of huggingface-hub on x86_64,
arm64 and aarch64, not just an extra, so `[hf_xet]` selected nothing that the
plain package does not already pull in. The plain install still provides the
`hf`, `huggingface-cli` and `tiny-agents` executables.

Applies to the remaining seven translations and archived READMEs too, which
still carried the `[cli,hf_xet]` form whose `cli` extra no longer exists.

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: nanaoto <10inspiral@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-08-12 07:57:28 +08:00
..
2025-09-08 17:36:39 +08:00