Skip to content

frankdierolf/whis

Repository files navigation

whis

whis

Your voice, piped to clipboard.
Website · Desktop · Mobile · Releases

Why?

  • Built for AI workflows — speak your prompt, paste to OpenCode, Claude, Codex, ...
  • Cloud or local — OpenAI, Mistral, Groq, Deepgram, ElevenLabs, or free with local Whisper
  • Simple — record → transcribe → clipboard

Quick Start

# Install
cargo install whis

# Setup (pick one)
whis setup cloud   # Cloud providers (guided wizard)
whis setup local   # Fully local (private, free)

# Run
whis               # Press Enter to stop — text copied!

Screenshot

whis Demo

Usage

# Record once
whis

# Background hotkey mode
whis listen        # Ctrl+Alt+W toggles recording

# Post-process with AI (cleanup grammar/filler)
whis --post-process

# Use with terminal AI assistants
claude "$(whis --as ai-prompt)"   # Start session with voice prompt
!whis --as ai-prompt              # Or use shell mode inside session

# Presets
whis --as email          # Use preset
whis presets             # List all
whis presets new xyz     # Create new preset
whis presets edit xyz    # Edit in $EDITOR

# Transcribe existing audio 
whis -f audio.mp3

# Help - for you or your helper
whis --help 

Installation

cargo install whis

Or download binaries from GitHub Releases.

Requirements

  • API key from OpenAI, Mistral, Groq, Deepgram, or ElevenLabs — or use local Whisper (no API key needed)
  • FFmpeg (sudo apt install ffmpeg, brew install ffmpeg, or scoop install ffmpeg)
  • Linux (X11/Wayland), macOS, or Windows

For hotkey mode (one-time setup on Linux):

sudo usermod -aG input $USER
echo 'KERNEL=="uinput", GROUP="input", MODE="0660"' | sudo tee /etc/udev/rules.d/99-uinput.rules
sudo udevadm control --reload-rules && sudo udevadm trigger
# Logout and login again

Desktop & Mobile

  • Desktop — GUI with system tray
  • Mobile — Android app (Alpha)

Development

git clone https://github.com/frankdierolf/whis.git
cd whis
just                # List all commands
just install-cli    # Build and install CLI

See CONTRIBUTING.md for full setup instructions.

Architecture

Whis Architecture

License

MIT