Model card: search keywords, voice table, FAQ, links

README.md

@@ -8,28 +8,53 @@ tags:
   - text-to-speech
   - tts
   - speech-synthesis
-  - conversational
-  - nonverbal
-  - laughter
-  - onnx
-  - flow-matching
+  - neural-tts
+  - offline-tts
   - on-device
+  - edge-ai
   - edge
   - offline
   - cpu
+  - onnx
+  - onnxruntime
+  - lightweight
+  - small-model
+  - flow-matching
+  - vocos
+  - english
+  - raspberry-pi
+  - flockspeech
+  - conversational
+  - conversational-ai
+  - expressive-tts
+  - nonverbal
+  - laughter
+  - disfluency
+  - voice-assistant
+  - game-audio
 datasets:
   - amaai-lab/DisfluencySpeech
 ---
 
-# Goldfinch v0.1
+# Goldfinch v0.1: tiny conversational text-to-speech (TTS) that laughs on cue
 
-**A small conversational English text-to-speech model that laughs, breathes and says "uh", offline on a CPU.**
+**A small, expressive English text-to-speech model that laughs, breathes and says "uh", offline on any CPU. 44 MB, no
+GPU, no cloud.**
 
 Goldfinch is an 11.4M-parameter flow-matching TTS model from [Flock Speech](https://huggingface.co/flockspeech). Where
 its sibling [Junco](https://huggingface.co/flockspeech/junco) reads aloud, Goldfinch talks: it keeps fillers such as
 "uh" and "you know", restarts like "I, I think", and non-speech sounds you place with tags such as `[laugh]`. It runs
 faster than real time on an ordinary CPU, with no GPU, network or PyTorch dependency.
 
+Goldfinch is the **conversational voice** of the Flock Speech family, for chat companions, game characters,
+conversational AI and voice assistants that should sound casual and human, on-device and offline. Install it with
+`pip install flockspeech`.
+
+| Flock Speech voices | Style | Model card |
+|---|---|---|
+| **Goldfinch** | conversational voice that laughs and breathes on cue with `[laugh]` tags | this page |
+| **Junco** | clear, neutral reading voice | [flockspeech/junco](https://huggingface.co/flockspeech/junco) |
+
 | | |
 |---|---|
 | **Developed by** | Flock Speech |
@@ -217,6 +242,35 @@ A cosine learning-rate schedule trained in parallel did no better, so we release
 
 **Environmental impact.** About 6.2 GPU-hours on NVIDIA T4s (70 W TDP), for both runs, or about 0.43 kWh.
 
+## FAQ
+
+**How do I make it laugh?**
+Write `[laugh]` where the laugh should go: `Goldfinch()("That's hilarious. [laugh] No, really.")`. The same works for
+`[breath]`, `[throat]`, `[lipsmack]`, `[sigh]` and `[noise]`; see [Sound tags](#sound-tags).
+
+**Do I need to tag "uh" and "um"?**
+No. Write fillers as ordinary words ("uh", "um", "you know", "I mean") and Goldfinch says them naturally.
+
+**Does it need a GPU or an internet connection?**
+No. It runs on an ordinary CPU with ONNX Runtime. Once installed, speech is generated fully offline and your text
+never leaves the machine.
+
+**How big is it?**
+44.2 MB in total: a 17.1 MB acoustic model plus the 27.1 MB Vocos vocoder, shared with Junco. Both voices together
+take 61.3 MB. A full-precision (fp32) build is also in this repository.
+
+**Can it run on a Raspberry Pi or other ARM boards?**
+It runs on 64-bit ARM Linux wherever `onnxruntime` and `espeakng-loader` publish wheels, including 64-bit Raspberry
+Pi OS.
+
+**Does it support voice cloning or emotions?**
+No voice cloning: Goldfinch is one English (US) voice. Expressiveness comes from fillers and the sound tags above,
+not from emotion labels.
+
+**Can I use it commercially?**
+The weights are Apache-2.0 and the vocoder is MIT. The phonemiser (espeak-ng, phonemizer) is GPL-3.0 and is installed
+separately, and the training texts come from Switchboard transcripts; see the License section below.
+
 ## License
 
 - **Goldfinch weights and configuration:** [Apache License 2.0](LICENSE).
@@ -241,6 +295,12 @@ included in this repository. See [NOTICE](NOTICE).
 }
 ```
 
+## Links
+
+- Python package: [pypi.org/project/flockspeech](https://pypi.org/project/flockspeech/)
+- Source code: [github.com/flockspeech/flockspeech](https://github.com/flockspeech/flockspeech)
+- Reading voice: [flockspeech/junco](https://huggingface.co/flockspeech/junco)
+
 ## Acknowledgements
 
 Goldfinch is trained on DisfluencySpeech from the AMAAI Lab. It builds on ideas from