Skip to main content

​
Install via Homebrew

The recommended way to install Klaus on macOS is through Homebrew. This method handles all dependencies automatically, including Python, PortAudio, and required libraries.
1

Add the Klaus tap

brew tap bgigurtsis/klaus
2

Install Klaus

brew install klaus
This will install Klaus and all required dependencies including:
  • Python 3.11-3.13
  • PortAudio for audio handling
  • All Python packages (PyQt6, OpenCV, Anthropic SDK, etc.)
3

Launch Klaus

klaus
On first launch, a setup wizard will guide you through:
  • API key configuration
  • Camera selection
  • Microphone setup
  • Voice model download

​
macOS Permissions

Input Monitoring Permission RequiredmacOS may prompt you to grant your terminal Accessibility (input monitoring) permission. This is needed for global hotkeys (push-to-talk and voice-activation toggle) to work when Klaus is not focused.You can deny this prompt and still use Klaus through the in-app UI buttons instead.
macOS 26 + Python 3.14 CompatibilityThe pynput library used for global hotkeys can crash on macOS 26 with Python 3.14. Klaus automatically disables global hotkeys on this combination and keeps in-app hotkeys active.For stable global hotkeys, use Python 3.13.

​
Updating Klaus

To update Klaus to the latest version: 
brew upgrade klaus
Brew will check for updates and install the latest release.

​
Next Steps

After installation, proceed to:

Build docs developers (and LLMs) love

Get started for freeTalk to us