Install

Installation guide

Current version 0.3.2. Everything happens in Terminal: one command, then two or three questions.

Before you start

Mac
Apple silicon, macOS 14 or later.
Memory
At least 16 GB of memory. The two models take about 8 GB once loaded, and a Mac with 8 GB stops responding; with too little memory the installer stops before downloading anything.
Disk space
About 8 GB: two models totaling roughly 7 GB, plus a few hundred MB of Python packages.
Network
Needed only during installation, to download Trie, Python packages, and the models. Dictation itself works offline.
Privileges
No administrator password is required.

Install

  1. Open Terminal

    Press Command + Space, type Terminal, and press Return.

  2. Paste this command and press Return

    curl -fsSL https://trie.ai/install.sh | sh

    The script checks your system, downloads Trie and verifies it (both the file checksum and the developer signature must match, or it stops), installs it into Applications, and creates a separate Python environment.

  3. Answer the prompts

    If uv (the tool used to create the Python environment) is not installed, the script asks whether to install it.

    It then asks whether to download the two models, about 7 GB. Answer y and wait, or skip and run the same command again later.

  4. Allow three permissions

    Trie opens when installation finishes. On first use macOS asks for the three permissions below; allow all of them. If you miss a prompt, turn it on in System Settings → Privacy & Security. The installer's own messages are currently in Chinese.

    Microphone
    To hear you.
    Accessibility
    To paste text into the active text field.
    Input Monitoring
    To detect a tap of the right Command key on its own.
  5. Try it

    Click into any text field, tap the right Command key (⌘) on its own, say a sentence, and tap it again. The text is pasted into the field.

Common situations

Slow model download
The models come from huggingface.co. If it is hard to reach, set a mirror before running the install command: export HF_ENDPOINT=mirror-url. An interrupted download resumes when you run the command again.
Overlay says unavailable
Usually the models are not downloaded yet, or microphone access was not allowed. Running the install command again rechecks the models.
Right Command does nothing
Check that Trie is enabled under Accessibility and Input Monitoring, then quit and reopen Trie.
Why no direct download
Trie is signed with an Apple Developer ID; notarization is still being processed by Apple. Until it completes, macOS blocks the app when it is downloaded from a browser, so installation is offered from the command line only.
Upgrade
Run the same install command again. Models and personal settings are kept, and permissions do not need to be granted again.
Uninstall
curl -fsSL https://trie.ai/install.sh | sh -s -- --uninstall
Logs
~/Library/Logs/Trie/. Events and character counts only, never what you said.

Back to home