Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyprcore.ai/llms.txt

Use this file to discover all available pages before exploring further.

Hyprcore normally downloads models on demand from models.hyprcore.ai. If your network blocks that domain, or you’re setting up a Mac without network access, you can install models manually.

​
1. Find your app data directory

The directory is: 
~/Library/Application Support/ai.hyprcore.desktop/
Or open Hyprcore → Settings → About and copy the “App Data Directory” path. Or press ⌘⇧D to open the debug menu, which shows the path.

​
2. Create the models folder

mkdir -p ~/Library/Application\ Support/ai.hyprcore.desktop/models

​
3. Download the model files

The URLs are publicly accessible. Download from any browser or with curl:

​
Whisper models (single .bin files)

curl -L -o ggml-small.bin              https://models.hyprcore.ai/ggml-small.bin
curl -L -o whisper-medium-q4_1.bin     https://models.hyprcore.ai/whisper-medium-q4_1.bin
curl -L -o ggml-large-v3-turbo.bin     https://models.hyprcore.ai/ggml-large-v3-turbo.bin
curl -L -o ggml-large-v3-q5_0.bin      https://models.hyprcore.ai/ggml-large-v3-q5_0.bin
ModelSizeFilename
Whisper Small487 MBggml-small.bin
Whisper Medium492 MBwhisper-medium-q4_1.bin
Whisper Turbo1.6 GBggml-large-v3-turbo.bin
Whisper Large1.1 GBggml-large-v3-q5_0.bin

​
Parakeet models (compressed archives)

curl -L -o parakeet-v2-int8.tar.gz     https://models.hyprcore.ai/parakeet-v2-int8.tar.gz
curl -L -o parakeet-v3-int8.tar.gz     https://models.hyprcore.ai/parakeet-v3-int8.tar.gz

​
Silero VAD (required)

curl -L -o silero_vad_v4.onnx          https://models.hyprcore.ai/silero_vad_v4.onnx

​
4. Install

​
Whisper

Drop the .bin files directly into the models directory. Don’t rename them—Hyprcore identifies them by filename. 
~/Library/Application Support/ai.hyprcore.desktop/models/
├── ggml-small.bin
├── whisper-medium-q4_1.bin
├── ggml-large-v3-turbo.bin
└── ggml-large-v3-q5_0.bin

​
Parakeet

Extract the .tar.gz archives and place the resulting directories—not the archives—in models. The directory names matter exactly: 
tar -xzf parakeet-v3-int8.tar.gz
mv parakeet-tdt-0.6b-v3-int8 ~/Library/Application\ Support/ai.hyprcore.desktop/models/

~/Library/Application Support/ai.hyprcore.desktop/models/
├── parakeet-tdt-0.6b-v2-int8/
│   └── (model files)
└── parakeet-tdt-0.6b-v3-int8/
    └── (model files)
The Parakeet directory name must match exactly. Renaming it breaks detection.

​
Silero VAD

The Silero VAD file goes in a slightly different place if you’re building from source (see the desktop README). For installed app users, it’s bundled inside the app.

​
5. Verify

  1. Restart Hyprcore.
  2. Open Settings → Models.
  3. Manually-installed models appear as Downloaded.
  4. Select one and run a test transcription.
If a model doesn’t appear, check that:
  • The filename or directory name matches exactly.
  • The file isn’t corrupted (compare sizes against the table above).
  • You restarted Hyprcore after copying the files.

​
Updating

When Hyprcore ships a new version of a model, the URL stays the same but the file changes. To update, re-download and overwrite. Hyprcore detects the change on next launch.