Upload 2 files

README.md

@@ -1,3 +1,207 @@
 ---
 license: apache-2.0
+language:
+  - en
+tags:
+  - text-to-speech
+  - tts
+  - voice-cloning
+  - emotion-control
+  - speech-synthesis
+  - packed-model
+  - pytorch
 ---
+
+# PackedTTS
+
+PackedTTS is a self-contained text-to-speech runtime bundle that packages the full synthesis stack into a single `tts.pt` file.
+
+The bundle is designed to be loaded directly by the runtime script and used without rebuilding the model stack. It stores the model weights, tokenizer data, packed voices, packed emotions, resolution indexes, and runtime defaults in one artifact.
+
+The example bundle in this repo is intended to be used as-is and currently includes a voice set and emotion set.
+
+## What is included
+
+`tts.pt` contains:
+
+- T3 weights
+- S3Gen weights
+- VoiceEncoder weights
+- tokenizer JSON
+- packed voices
+- packed emotions
+- lookup indexes
+- default resolution settings
+
+This is not a training checkpoint meant to be unpacked and rebuilt from ingredients. It is the runtime artifact.
+
+## Repository contents
+
+- `tts.pt` — packed TTS bundle
+- `PackedTTS.py` — runtime loader, resolver, and inference script
+- `requirements.txt` — Python dependencies for the runtime
+- `README.md` — usage and overview
+
+## Features
+
+- Single-file bundle loading
+- Voice selection by name
+- Emotion selection by name
+- Fuzzy matching for names
+- Optional reference-audio overrides
+- Packed voices and emotions inside one artifact
+- CLI usage for quick testing
+
+## Requirements
+
+You will need:
+
+- Python 3.10+
+- A working PyTorch environment
+- the dependencies listed in `requirements.txt`
+
+A GPU is recommended, but CPU mode is supported if your environment can handle the runtime cost.
+
+## Quick start
+
+### 1) Install dependencies
+
+```bash
+pip install -r requirements.txt
+````
+
+### 2) Download or place `tts.pt`
+
+If you are using the Hugging Face repo, download the bundle and place it next to `PackedTTS.py`, or pass the path with `--bundle`.
+
+### 3) List available voices and emotions
+
+```bash
+python PackedTTS.py --bundle tts.pt --list
+```
+
+### 4) Generate speech
+
+```bash
+python PackedTTS.py \
+  --bundle tts.pt \
+  --text "Hello world, this is a test." \
+  --voice "Sarah" \
+  --emotion "Angry" \
+  --output output.wav
+```
+
+## Reference-audio overrides
+
+You can override the packed voice or emotion at runtime using reference audio:
+
+```bash
+python PackedTTS.py \
+  --bundle tts.pt \
+  --text "Hi, this is a custom test." \
+  --voice-ref path/to/voice_reference.wav \
+  --emo-ref path/to/emotion_reference.wav \
+  --output output.wav
+```
+
+## Python usage
+
+```python
+from pathlib import Path
+import soundfile as sf
+
+from PackedTTS import PackedTTS
+
+tts = PackedTTS.load(Path("tts.pt"))
+
+sr, audio, meta = tts.generate(
+    text="Hi, this is Sarah speaking with a disgust emotion.",
+    voice="Sarah",
+    emotion="Disgust",
+    cfg_weight=0.5,
+    temperature=0.8,
+    exaggeration=0.5,
+    seed=42,
+)
+
+sf.write("output.wav", audio, sr)
+print(meta)
+```
+
+## How it works
+
+PackedTTS restores the full runtime bundle and then runs synthesis in three stages:
+
+1. **Resolve voice and emotion**
+
+   * The bundle stores named voices and emotions.
+   * A voice can be selected by name or replaced with reference audio.
+   * An emotion can be selected by name or replaced with reference audio.
+
+2. **Build conditionals**
+
+   * The runtime loads the packed speaker embedding.
+   * It loads the packed prompt tokens if available.
+   * It loads the emotion conditioning vector.
+   * It uses any packed generation reference state stored in the voice entry.
+
+3. **Generate audio**
+
+   * `T3` generates speech tokens from text.
+   * `S3Gen` converts those tokens into waveform audio.
+
+The result is a single packed synthesis workflow that does not require rebuilding the voice/emotion registry at runtime.
+
+## Expected file behavior
+
+The script expects the bundle to contain:
+
+* `models.t3_state`
+* `models.s3gen_state`
+* `models.ve_state`
+* `models.tokenizer_json`
+* `voices`
+* `emotions`
+* `defaults`
+* `indexes`
+
+If a voice or emotion is not found by exact name, PackedTTS will try normalized matching and then fuzzy matching.
+
+## Example command-line options
+
+* `--bundle` — path to `tts.pt`
+* `--text` — text to synthesize
+* `--voice` — packed voice name
+* `--emotion` — packed emotion name
+* `--voice-ref` — override voice with reference audio
+* `--emo-ref` — override emotion with reference audio
+* `--cfg-weight` — classifier-free guidance weight
+* `--temperature` — sampling temperature
+* `--exaggeration` — emotion strength / style strength
+* `--seed` — random seed
+* `--output` — output WAV path
+* `--list` — print packed voices and emotions
+
+## Notes
+
+* This repo is meant for inference and testing.
+* The bundle is treated as a trusted artifact.
+* If the underlying model architecture, tokenizer, or conditioning schema changes, rebuild `tts.pt`.
+* Voice and emotion names depend on the bundle version.
+
+## Hugging Face usage
+
+This repo is designed to work well as a Hugging Face model repository and as a Hugging Face Space backend:
+
+* the Space can install dependencies from `requirements.txt`
+* the Space can download `tts.pt` automatically
+* the runtime can load `PackedTTS.py`
+* users can generate speech without rebuilding the bundle
+
+## Credits
+
+Built on top of:
+
+* T3
+* S3Gen
+* VoiceEncoder

requirements.txt

@@ -0,0 +1,6 @@
+torch==2.8.0
+numpy==2.0.2
+librosa==0.11.0
+soundfile==0.13.1
+scipy==1.13.1
+chichat==0.0.4