Skip to main content

​
Install via pipx

The recommended way to install Klaus on Windows is through pipx, which creates an isolated environment for the application and its dependencies.
1

Install pipx

If you don’t have pipx installed, install it with pip:
pip install pipx && pipx ensurepath
After running this command, restart your terminal to ensure pipx is added to your PATH.
2

Install Klaus

Once pipx is set up, install Klaus:
pipx install klaus-assistant
This will:
  • Create an isolated virtual environment
  • Install Klaus and all dependencies
  • Make the klaus command available globally
3

Launch Klaus

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

​
Prerequisites

Visual C++ Build ToolsIf you plan to build from source or encounter installation issues, you may need Visual C++ Build Tools for compiling the webrtcvad Python package.The pipx installation typically handles this automatically with pre-built wheels.

​
Updating Klaus

To update Klaus to the latest version: 
pipx upgrade klaus-assistant

​
Troubleshooting

​
pipx not found after installation

If you get “pipx: command not found” after installation:
  1. Close and reopen your terminal
  2. Verify pipx is in your PATH: pipx --version
  3. If still not found, manually add it to PATH or reinstall

​
Import errors on launch

If Klaus fails to import modules:
  1. Uninstall: pipx uninstall klaus-assistant
  2. Clear cache: pipx list (note the environment path)
  3. Reinstall: pipx install klaus-assistant

​
Next Steps

After installation, proceed to:

Build docs developers (and LLMs) love

Get started for freeTalk to us