How to install WhimprFlow on Mac

Before you start

These are one-time installs. If you have used Terminal before, you may have them already — the first step checks.

1. 1

   Install Git

   Apple opens a small installer.

   Type this into Terminal, then press Return.

   xcode-select --install

   You know this worked when: Git responds with a version number

2. 2

   Install Node LTS

   Choose the macOS Installer (.pkg).

   Open download ↗

   You know this worked when: Node responds with a version number

Install WhimprFlow

1. 3

   Open Terminal

   Keep it open beside this page.

   You know this worked when: Terminal is open

2. 4

   Check Git and Node

   Use Terminal. Git and the current Node LTS are required.

   Type this into Terminal, then press Return.

   git --version
   node --version

   You know this worked when: Git and Node respond with version numbers

3. 5

   Install pnpm

   The interface is a pnpm project.

   Type this into Terminal, then press Return.

   npm install -g pnpm

   You know this worked when: pnpm responds with a version number

4. 6

   Install Rust

   Run the single command the page shows, then reopen Terminal.

   Open rustup ↗

   You know this worked when: cargo responds with a version number

5. 7

   Copy WhimprFlow to this Mac

   Type this into Terminal, then press Return.

   cd ~
   if [ ! -d WhimprFlow/.git ]; then
   git clone https://github.com/Blueturboguy07/WhimprFlow.git
   fi

   You know this worked when: A WhimprFlow folder appears

6. 8

   Open the WhimprFlow folder

   Type this into Terminal, then press Return.

   cd WhimprFlow

   You know this worked when: Your terminal prompt is inside the WhimprFlow folder

7. 9

   Use the reviewed version

   Type this into Terminal, then press Return.

   git checkout 22c8d619a8cb87750d1b74b62c4fcb05c59ea55a

   You know this worked when: Git reports the reviewed commit

8. 10

   Install the interface packages

   The last line fixes a pnpm build-approval quirk — it's a no-op when not needed.

   Type this into Terminal, then press Return.

   cd ui
   pnpm install
   cd ..
   pnpm --dir ui approve-builds --all || true

   You know this worked when: The install finishes without an error

9. 11

   Make the speech model folder

   The model is too large to ship in the repository.

   Type this into Terminal, then press Return.

   mkdir -p "$HOME/Library/Application Support/WhimprFlow/models"

   You know this worked when: The models folder exists

10. 12

    Download the speech model

    About 150MB — the command fetches it straight into the models folder.

    Type this into Terminal, then press Return.

    if [ ! -f "$HOME/Library/Application Support/WhimprFlow/models/ggml-base.en.bin" ]; then
    curl -f -L -o "$HOME/Library/Application Support/WhimprFlow/models/ggml-base.en.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin
    fi

    You know this worked when: ggml-base.en.bin sits in the models folder

11. 13

    Build the app

    The first build compiles Whisper, so it takes a while.

    Type this into Terminal, then press Return.

    ui/node_modules/.bin/tauri build --bundles app

    You know this worked when: A WhimprFlow.app appears in the bundle folder

12. 14

    Put WhimprFlow in Applications

    Copy the freshly built app into Applications so it's a real, launchable Mac app.

    Type this into Terminal, then press Return.

    ditto target/release/bundle/macos/WhimprFlow.app /Applications/WhimprFlow.app

    You know this worked when: WhimprFlow.app is in your Applications folder

13. 15

    Open WhimprFlow

    Launch it to finish setup — and so it shows up in your apps list.

    Type this into Terminal, then press Return.

    open /Applications/WhimprFlow.app

    You know this worked when: WhimprFlow opens

14. 16

    Choose how speech is cleaned up

    In Settings pick OpenAI and paste a key, or keep the raw transcript.

    You know this worked when: Settings saves without an error

15. 17

    Allow microphone and accessibility

    Both live in Privacy & Security. It types for you, so it needs them.

    You know this worked when: WhimprFlow reports both as granted

16. 18

    Hold Fn and speak

    Release the key and your words land where the cursor is.

    You know this worked when: Clean text appears in the app you were typing in

If something goes wrong

Nothing here can damage your computer, and every step can be run again safely. If a command fails, the usual cause is the step before it not having finished.

Still stuck? Tell us what happened and we will fix the guide. Include the step number and we can usually reproduce it.