stacks/index-tts: revert git-lfs build attempt; document the LFS

budget hazard + media-CDN workaround

Tried adding git-lfs install + git lfs pull to the build to get
real example WAVs into the image — failed with:

    Error downloading object: examples/emo_hate.wav: Smudge error:
    batch response: This repository exceeded its LFS budget. The
    account responsible for the budget should increase it to
    restore access.

The index-tts org's LFS bandwidth quota is exhausted upstream and
out of our control. Reverting the Dockerfile change. The examples
aren't needed for the wrapper to work; emotion_text and
emotion_vector are sufficient for end-to-end testing without any
WAV file at all.

For users who want the bundled example clips as starter audio,
README now documents the media-CDN URL trick — same LFS objects
served via a different code path that doesn't count against the
LFS API budget. INDEX_TTS_TAG stays at v1.
This commit is contained in:
vh
2026-04-25 14:25:06 -07:00
parent 6fd35bfe37
commit ab696ecbd1
3 changed files with 32 additions and 15 deletions
+14 -11
View File
@@ -15,25 +15,28 @@ ENV DEBIAN_FRONTEND=noninteractive \
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
python3.10 python3.10-venv python3-pip \
git git-lfs ffmpeg libsndfile1 \
git ffmpeg libsndfile1 \
ca-certificates wget \
&& rm -rf /var/lib/apt/lists/* \
&& python3.10 -m venv /opt/venv \
&& git lfs install --system
&& python3.10 -m venv /opt/venv
# Pinned IndexTTS-2 SHA — bump in stack .env (INDEX_TTS_SHA build arg)
# when you want upstream updates.
#
# `git lfs pull` after the checkout fetches examples/emo_*.wav and the
# example/voice_*.wav reference clips that are stored as LFS objects.
# Without it, the .wav files come down as ~130-byte LFS pointer text
# files, and `docker cp`-ing them out as starter material for
# /worktank/index-tts/{voices,emotions} produces unusable garbage.
# Note on LFS: examples/emo_*.wav and examples/voice_*.wav in the
# upstream repo are Git LFS objects, but the index-tts org has
# repeatedly exhausted GitHub's LFS bandwidth budget — `git lfs pull`
# in the build aborts with "This repository exceeded its LFS budget".
# We don't need the examples for the wrapper to work; they're just
# convenient starter audio. To stage real LFS-backed examples on the
# host, fetch them once via the media CDN (a different code path that
# doesn't count against the LFS API budget):
#
# curl -fsSL -o /worktank/index-tts/emotions/hate.wav \
# https://media.githubusercontent.com/media/index-tts/index-tts/main/examples/emo_hate.wav
ARG INDEX_TTS_SHA=830f6f8f94a51fea23ab1d639027a86200075a4e
RUN git clone https://github.com/index-tts/index-tts.git /opt/index-tts \
&& cd /opt/index-tts \
&& git checkout ${INDEX_TTS_SHA} \
&& git lfs pull
&& cd /opt/index-tts && git checkout ${INDEX_TTS_SHA}
# CUDA 12.8 torch wheels (per IndexTTS pyproject.toml's tool.uv.index
# pin — same versions, same source).