shh

Voice transcription CLI powered by OpenAI Whisper
Record audio, transcribe with Whisper, and optionally format or translate the output.

Get Started View on GitHub

Features

• One-command recording

  ---

  Start with shh, stop with Enter. No configuration needed.

• AI formatting

  ---

  Clean up transcriptions in casual, business, or neutral styles.

• Translation

  ---

  Transcribe and translate to any language in one command.

• Clipboard integration

  ---

  Results automatically copied for instant use.

• Async architecture

  ---

  Non-blocking operations for responsive UX.

• Live progress

  ---

  Real-time recording indicators with elapsed time.

Quick Start

# Install
pipx install shh-cli

# Configure API key
shh setup

# Record (press Enter to stop)
shh

Results appear in terminal and clipboard.

Documentation

• Installation - Setup instructions
• Quick Start - Get started in 2 minutes
• Commands - All available commands
• Configuration - Settings and defaults
• API Reference - Code documentation

Requirements

• Python 3.11+
• OpenAI API key
• Microphone