Installation ​

Whisper runs on macOS (Apple Silicon and Intel) and Windows (x64). Installation takes about 30 seconds.

Before you install

You'll need a Whisper account. Go to whisper.fans, request access, and wait for approval. You can install the CLI while you wait, but you'll need an approved account before you can use it.

Install on macOS ​

Open the Terminal app on your Mac. You can find it by pressing Cmd + Space and typing "Terminal."

We recommend Hyper

Whisper was designed to look its best in Hyper, a free terminal app. The colors, ASCII art, and overall experience are tuned for it. Download it at hyper.is, install it, and use it instead of the built-in Terminal. Totally optional though. Any terminal works.

Paste this command and press Enter:

bash
curl -fsSL https://releases.whisper.fans/releases/install.sh | bash

You'll see output like this:

Detected platform: darwin-arm64
Fetching latest release info...
Latest version: v1.3.11
Downloading whisper-darwin-arm64...
Verifying checksum... OK
Installing to ~/.local/bin/whisper...
Installation complete! Run 'whisper' to get started.

Install on Windows ​

Open PowerShell. You can find it by pressing Win + X and selecting "Terminal" or "PowerShell," or by searching for "PowerShell" in the Start menu.

We recommend Hyper

Whisper was designed to look its best in Hyper, a free terminal app. The colors, ASCII art, and overall experience are tuned for it. Download it at hyper.is, install it, and use it instead of PowerShell. Totally optional though. Any terminal works.

Paste this command and press Enter:

powershell
irm https://releases.whisper.fans/releases/install.ps1 | iex

You'll see output like this:

Detected platform: windows-x64
Fetching latest release info...
Latest version: v1.3.11
Downloading whisper-windows-x64...
Verifying checksum... OK
Installing to ~/.local/bin/whisper.exe...
Installation complete! Run 'whisper' to get started.

After Installing ​

Close your terminal window and open a new one. This makes sure your system can find the whisper command.

Then verify it worked by typing:

bash
whisper --version

You should see a version number like 1.3.11. If you see that, you're all set.

What just happened?

The install command downloaded the Whisper program and saved it to ~/.local/bin/. It also made sure your terminal knows where to find it. That's it. Nothing else was changed on your computer.

Troubleshooting ​

macOS ​

"command not found" after installing?

Make sure you opened a new Terminal window after installing. If it still doesn't work, run this and try again:

bash
source ~/.zshrc

Still stuck?

Check that the file was actually installed:

bash
ls ~/.local/bin/whisper

If the file is there but the command still isn't found, your Terminal's PATH might need updating. Run this once:

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Windows ​

"whisper is not recognized" after installing?

Close your PowerShell window and open a new one. The installer adds Whisper to your PATH, but existing windows need to be restarted to pick it up.

Still stuck?

Check that the file was actually installed:

powershell
Test-Path "$HOME\.local\bin\whisper.exe"

If that returns True but the command still isn't found, add the folder to your PATH manually:

powershell
[Environment]::SetEnvironmentVariable('Path', "$HOME\.local\bin;$([Environment]::GetEnvironmentVariable('Path', 'User'))", 'User')

Then close and reopen PowerShell.

Next Step ​

Now that Whisper is installed, head to Setup to connect it to your account.