Golos mascot

Golos

Hold a hotkey, speak, release. Your words get pasted.

A free, open-source alternative to WisprFlow. macOS CLI powered by Deepgram.

Install

curl -fsSL https://raw.githubusercontent.com/basilysf1709/golos/main/install.sh | bash

Requires macOS and Homebrew. The installer handles portaudio and places the binary at /usr/local/bin/golos.

Quick Start

1

Install Golos

Run the curl command above. It installs portaudio and the golos binary.
2

Grant Accessibility Permission

Go to System Settings → Privacy & Security → Accessibility and enable your terminal app (Terminal, iTerm2, Alacritty, etc.).
3

Configure your API key

Run golos setup to enter your Deepgram API key.
golos

Hold Right Option to record, release to transcribe and paste.

Read the DocsGitHub