Files

T

Palash Debnath 3cae853440 feat(catalogue): one page, one axis — setup summary over per-family engines and weights

The Model Catalogue put the same decision on two axes: an Engines pane with
TTS/ASR/LLM tabs and a Models pane with TTS/ASR/Dictation/Diarisation
sections, dictation shown in both, plus storage stats, the HF token and the
voice-preview toggle parked on the model list. Settings → Voice still carried
Engines and Models entries that only pointed back here.

Now the page reads top-down: a SetupSummary (speech, transcription,
dictation, language model — engine, device, one status word, Change), the
engine list for one family, and that family's downloadable weights under it
(TTS under TTS; offline ASR, streaming dictation and diarisation under ASR;
nothing for LLM, whose engines bring their own). One storage line points at
Settings → Storage.

- ModelStoreTab takes a `family` and scopes sections and the recommendation
  preset to it (scopeReco); stats strip, HF-token toolbar and previews
  panel removed from it.
- Settings: Engines/Models categories and CataloguePointer removed; models
  directory → Storage, HF mirror → Network (both restart-flagged), voice
  previews → Storage. "Manage models" in disk usage opens the catalogue.
- Store: openCatalogue takes a family (pane key tolerated, ignored);
  pendingCatalogueTab gone.
- Engine matrix title is now the locale's plain "Engines".
- i18n: catalogue.* summary keys in all 21 locales; pane/pointer keys dropped.
- Docs: "Model Catalogue → Engines" is "Model Catalogue"; "→ Models" is
  "→ Downloaded weights".

2026-09-10 06:46:09 -07:00

5.2 KiB

Raw Permalink Blame History

VoiceStudio — IndexTTS 2.5

IndexTTS 2.5 is an optional, multilingual voice-cloning engine for dubbing and expressive speech. It supports Chinese, English, Japanese, Spanish, and Arabic, with reference-audio cloning, emotion references, emotion vectors, and text-directed emotion.

VoiceStudio runs IndexTTS in a dedicated subprocess and Python environment. This keeps its transformers<5 dependency isolated from VoiceStudio's runtime. Existing user-managed IndexTTS-2 environments remain supported.

Install

IndexTTS 2.5 is not bundled because its source environment and model weights require substantial disk space.

Open Model Catalogue.
Expand IndexTTS 2.5 and select Install.
Keep VoiceStudio open while source, dependencies, and weights download.

The installer:

checks for uv and at least 12 GB of free space;
installs the reviewed indextts-2.5 source revision in an isolated venv;
downloads the reviewed IndexTeam/IndexTTS-2.5 model revision;
resumes partial model downloads;
saves OMNIVOICE_INDEXTTS_DIR and activates the engine without a restart.

An app-managed IndexTTS-2 checkout remains intact while 2.5 installs into a separate directory. VoiceStudio switches to 2.5 only after the new source, environment, and weights pass verification. User-managed clones are never modified or removed; their legacy indextts.infer_v2 entry point remains supported.

Manual install

Use a separate checkout and venv. Do not install IndexTTS into VoiceStudio's root environment.

git clone --branch indextts-2.5 https://github.com/index-tts/index-tts.git
cd index-tts
uv venv .venv
uv pip install --python .venv/bin/python -e .
hf download IndexTeam/IndexTTS-2.5 --local-dir=checkpoints

On Windows, replace .venv/bin/python with .venv\Scripts\python.exe. Then set OMNIVOICE_INDEXTTS_DIR to the checkout root:

export OMNIVOICE_INDEXTTS_DIR=/path/to/index-tts

[Environment]::SetEnvironmentVariable(
  "OMNIVOICE_INDEXTTS_DIR",
  "$env:USERPROFILE\code\index-tts",
  "User"
)

Restart VoiceStudio after setting a persistent environment variable outside the app.

Compatibility

VoiceStudio probes these locations in order:

${OMNIVOICE_INDEXTTS_DIR}/.venv/;
backend/engines/indextts/.venv/;
a venv bootstrapped from OMNIVOICE_INDEXTTS_DIR.

The probe prefers indextts.infer_v2_5 and falls back to indextts.infer_v2. A timed-out import is treated as unproven rather than missing, preventing slow disks or antivirus scans from hiding a valid venv. Set OMNIVOICE_INDEXTTS_IMPORT_PROBE_TIMEOUT_S to raise the default 60-second probe limit.

Long-text generation

A long passage can keep infer() busy for several minutes. The sidecar emits a keep-alive frame every 5 seconds while it works, so the parent can tell a slow synthesis from a wedged one, and waits up to 900 seconds for a sidecar that has gone genuinely silent. Set OMNIVOICE_INDEXTTS_RECV_TIMEOUT_S (minimum 30) to tune that ceiling.

IndexTTS 2.5 requires a language token. VoiceStudio maps locale codes and language names to the five supported languages and detects Chinese, Japanese, or Arabic script for Auto requests. Ambiguous Latin text defaults to English.

IndexTTS 2.5 uses duration_factor for native duration guidance. VoiceStudio's dubbing fit stage remains responsible for exact segment timing. Legacy IndexTTS-2 installations continue receiving their target_tokens control.

Troubleshooting

Engine unavailable

Use Model Catalogue → IndexTTS 2.5 → Install. For a manual install, confirm that the configured directory contains:

pyproject.toml
indextts/infer_v2_5.py
checkpoints/config.yaml

IndexTeam/IndexTTS-2.5 ships the model config as config.yaml. Earlier installs only worked after hand-renaming it to config_v2_5.yaml; both names are accepted, so a renamed checkout keeps working as-is and needs no reinstall.

`uv` not found

Install uv from https://docs.astral.sh/uv/ or configure the bundled binary through OMNIVOICE_BUNDLED_UV.

Import fails after installation

For an app-managed install, retry Install to repair the source and venv. For a manual install, run:

uv pip install --python .venv/bin/python -e .

Insufficient disk space

Free the amount reported by the installer, then retry. Completed model files are reused.

License

IndexTTS 2.5 uses the bilibili Model Use License. It grants a limited, worldwide, non-exclusive, royalty-free license subject to its restrictions. A separate license is required when the user or an affiliate exceeded 100 million monthly active users in the preceding month or RMB 1 billion in annual revenue in the preceding year. The agreement also includes downstream, derivative-work, prohibited-use, attribution, and compliance obligations. Review the official license before installing or using the model.

This model is not covered by VoiceStudio's blanket commercial-use statement. Organizations above either threshold must obtain Bilibili's separate written license before installing or using IndexTTS 2.5. Other engines remain available without enabling this optional sidecar.

See Engine venvs and disk usage for storage details.

5.2 KiB Raw Permalink Blame History