Skip to content

README.md

Latest commit

 

History

History
58 lines (43 loc) · 1.32 KB

README.md

File metadata and controls

58 lines (43 loc) · 1.32 KB

WisprFlow Lite - Python CLI Version

This is the original command-line Python voice transcription application.

Quick Start

  1. Setup Virtual Environment: 
    cd python-cli
python3 -m venv venv

macOS/Linux


2. **Install Dependencies**:
```bash
pip install -r requirements.txt

  1. Configure API Key:

    cp .env_example .env
# Edit .env and add your OpenAI API key

  2. Run Application:

    python voice_transcriber.py

Usage

  • Press and hold Option/Alt key to record
  • Release to transcribe and type text
  • Press Ctrl+C to quit

macOS Permissions

The app requires these permissions:

  • Microphone access
  • Accessibility access (for typing text)
  • Input Monitoring (for global hotkeys)

See ../docs/macos-setup.md for detailed setup instructions.

Configuration

Edit .env to customize:

  • OPENAI_API_KEY: Your OpenAI API key
  • LANGUAGE: Transcription language (en, es, fr, auto, etc.)
  • MAX_RECORDING_TIME: Maximum recording duration
  • REMOVE_FILLER_WORDS: Enable/disable filler word removal
  • TYPING_INTERVAL: Speed of text typing

Troubleshooting

  • No microphone detected: Check microphone permissions
  • Global hotkey not working: Enable Input Monitoring permissions
  • Text not typing: Enable Accessibility permissions