Use the fih banner; point quick start at setup_hebrew.sh

README.md

@@ -16,7 +16,7 @@ library_name: fish-speech
 pipeline_tag: text-to-speech
 ---
 
-![image](https://cdn-uploads.huggingface.co/production/uploads/63453ab89ad67b3d069effdf/Kq3sPWLcMbdmMHmqZWqPs.png)
+<img src="fih.png" alt="Fish Audio S2-Pro Hebrew" width="420">
 
 # Fish Audio S2-Pro — Hebrew (LoRA + atomic IPA tokens)
 
@@ -46,33 +46,33 @@ Code lives in the fork the adapter was trained with:
 ```bash
 git clone https://github.com/maxmelichov/fish-speech
 cd fish-speech && uv sync --python 3.12 --extra cu129
-pip install renikud-plus           # Hebrew grapheme-to-phoneme
+pip install renikud-plus                 # Hebrew grapheme-to-phoneme
 
-hf download fishaudio/s2-pro --local-dir checkpoints/s2-pro
-hf download notmax123/Fish-Audio-S2-Pro-He --local-dir checkpoints/he
-```
-
-Build the IPA-extended base checkpoint (symlinks the S2-Pro weights, drops the
-extended tokenizer and config on top), then synthesize:
-
-```bash
-python tools/hebrew/build_ipa_checkpoint.py \
-    --base checkpoints/s2-pro --output checkpoints/s2-pro-he-ipa
+bash tools/hebrew/setup_hebrew.sh        # base weights + this adapter + IPA checkpoint
 
 python tools/hebrew/infer_hebrew.py \
     --text "שלום, מה שלומך היום?" \
-    --base-checkpoint checkpoints/s2-pro-he-ipa \
-    --lora-checkpoint checkpoints/he/hebrew_lora_step2200.ckpt \
-    --lora-config r_32_alpha_16_core \
-    --ref-audio my_voice.wav --ref-text "..." \
+    --lora-checkpoint checkpoints/hebrew/hebrew_lora_step2200.safetensors \
     --output out.wav
 ```
 
+Add `--ref-audio my_voice.wav --ref-text "..."` to clone a voice.
+
 `infer_hebrew.py` runs plain unvocalized Hebrew through RenikudPlus G2P, maps the
 IPA to the atomic tokens, and chunks long inputs on sentence boundaries.
 `--lora-scale` scales the delta (0.0 = pure base model) if you want to dial the
 adaptation down.
 
+**Fine-tuning on your own Hebrew data** is one command — a directory per speaker
+of `*.wav` plus sibling `.lab` transcripts:
+
+```bash
+AUDIO_ROOT=my_audio tools/hebrew/run_hebrew_pipeline.sh
+```
+
+See [`tools/hebrew/README.md`](https://github.com/maxmelichov/fish-speech/blob/main/tools/hebrew/README.md)
+for the full guide.
+
 ## How it works
 
 **Atomic IPA tokens.** S2-Pro's BPE splits IPA into pieces that collide with