soubarnak
ea7be5f111
The fork takes its own name everywhere a user can see it: binaries (voculinux, voculinux-gui), desktop entry, autostart, tray, D-Bus namespace (com.voculinux.Voculinux, no alias for the old name), config/data/cache dirs, single-instance lock, IBus engine identity, tray icons, resource prefixes, VOCULINUX_* environment names, and the update-checker user agent. The internal Python module stays vocalinux and the distribution metadata keeps the upstream URLs as provenance. On first run a previous Vocalinux install's config.json, custom dictionary, and portal restore token are copied once into the new locations (new config always wins, no merge, no write-back); models re-resolve through the pinned-checksum download path. An offline naming-sweep test proves no old-name strings remain on user-visible surfaces outside the allowlist. Refs #18
62 lines
3.0 KiB
Markdown
62 lines
3.0 KiB
Markdown
# Choosing a speech model
|
|
|
|
Voculinux never downloads a speech model on its own. Changing the model pickers in
|
|
Settings → Speech Model only selects a model. If that model is not on disk yet, the
|
|
info card shows its download size and a **Download** button, and the transfer starts
|
|
only after you confirm it. Cancelling the download, or declining the confirmation,
|
|
puts the pickers back on the model you were already using.
|
|
|
|
This page is a static guide to help you pick. The numbers are approximate starting
|
|
points, not measurements of your machine. If dictation feels slow, go one size down;
|
|
if it makes too many mistakes and speed is fine, go one size up.
|
|
|
|
## whisper.cpp (default engine)
|
|
|
|
| Your hardware | Suggested size | Notes |
|
|
|---|---|---|
|
|
| Under 8 GB RAM, CPU only | Tiny | Fastest. Accuracy is noticeably lower. |
|
|
| 8 to 16 GB RAM, CPU only | Tiny or Base | Base is a good default on a recent CPU. |
|
|
| 16 GB RAM or more, CPU only | Base, or Small if you can wait | Small on CPU can take a few seconds per sentence. |
|
|
| Vulkan GPU (AMD, Intel, NVIDIA) with under 8 GB RAM | Base | |
|
|
| Vulkan GPU with 8 GB RAM or more | Small | Older or low power GPUs may still prefer Base. |
|
|
| NVIDIA GPU (CUDA) with under 4 GB VRAM | Base | |
|
|
| NVIDIA GPU (CUDA) with 4 to 8 GB VRAM | Small | |
|
|
| NVIDIA GPU (CUDA) with 8 GB VRAM or more | Medium, or Large v3 Turbo | Large v3 Turbo is close to Large in accuracy at lower cost. |
|
|
|
|
Settings → Speech Model may show a line such as "Suggested for this computer: Small".
|
|
That line is information only, based on the same rules as this table. It never changes
|
|
your model and never starts a download.
|
|
|
|
## Model sizes and variants
|
|
|
|
Each size comes in several variants. The quantized ones (`q5_0`, `q5_1`, `q8_0`) are
|
|
smaller files that use less memory, at a small cost in accuracy; `q8_0` is the
|
|
closest to the full model. The `.en` variants are English only and are a little
|
|
more accurate for English.
|
|
|
|
| Size | Full download | Q8_0 | Q5 | Parameters |
|
|
|---|---|---|---|---|
|
|
| Tiny | 74 MB | 32 MB | 15 MB (q5_1) | 39M |
|
|
| Base | 141 MB | 82 MB | 60 MB (q5_1) | 74M |
|
|
| Small | 465 MB | 190 MB | 163 MB (q5_1) | 244M |
|
|
| Medium | 1.4 GB | 823 MB | 568 MB (q5_0) | 769M |
|
|
| Large v3 Turbo | 1.6 GB | 874 MB | 574 MB (q5_0) | 809M |
|
|
| Large (v3) | 2.9 GB | | 1.1 GB (q5_0) | 1550M |
|
|
|
|
Sizes are the catalog values Voculinux shows before a download; the file on disk can
|
|
differ slightly.
|
|
|
|
If you already have a quantized model of the size you want (for example Small Q8_0),
|
|
there is no reason to download the full model of the same size.
|
|
|
|
## Other engines
|
|
|
|
- **Vosk**: the small models (about 40 MB) run on any CPU and are the lightest
|
|
option.
|
|
- **Faster Whisper** and **OpenAI Whisper**: the same size guidance as the table above.
|
|
- **Parakeet**: one model of about 640 MB.
|
|
- **Remote API**: transcription runs on your server, nothing is downloaded locally.
|
|
|
|
Models are stored under `~/.local/share/voculinux/models/` by default. Deleting a file there
|
|
removes the model; Voculinux will show it as not downloaded again.
|