whispa-app

Whispa App 🎙️➡️📝➡️🌍

Audio Transcription & Translation Desktop GUI
Powered by OpenAI's Whisper and MarianMT

Features ✨

• Audio Transcription
  Convert WAV/MP3/M4A files to text using 5 Whisper model sizes
  tiny | base | small | medium | large

• Text Translation
  Supports multiple languages including:

  • Spanish (es)
  • French (fr)
  • German (de)
  • Chinese (zh)
  • Japanese (ja)
  • Italian (it)
  • Portuguese (pt)
  • Russian (ru)
  • Arabic (ar)
  • Korean (ko)

• System Monitoring
  Real-time CPU/RAM/GPU usage stats

• Cross-Platform
  Windows installer available • Python package for developers

System Requirements 💻

• Python 3.10 or higher
• 4GB RAM minimum (8GB recommended)
• GPU support (optional):
  • NVIDIA GPU with CUDA support
  • 6GB VRAM recommended for large models
• Disk Space:
  • 500MB for base installation
  • 2-4GB for model downloads

Installation 🛠️

Windows Users

Download the installer (160MB) from GitHub Releases

• Run WhispaApp-Setup.exe
• Follow installation prompts
• Launch from Start Menu

Python Developers

# 1. Install CPU-optimized PyTorch (Windows)
pip install torch --index-url https://download.pytorch.org/whl/cpu

# For other platforms, use:
pip install torch

# 2. Install Whispa App
pip install whispa_app==2.2.0

# 3. Download models (first time)
whispa --prefetch

# 4. Launch GUI
whispa

Usage Guide 📖

Quick Start

• Browse for an audio file
• Select Model:
  • tiny: Fast, less accurate
  • base: Good balance
  • small: Better accuracy
  • medium: High accuracy
  • large: Best accuracy, slower
• Transcribe: Real-time progress tracking
• Translate: Choose target language
• Save: Export as TXT or clipboard

Advanced Settings

Setting	Description
VRAM Threshold	Minimum GPU memory for acceleration
Beam Size	Balance speed vs accuracy
VAD Filter	Skip silent segments
Language	Source language (auto-detect if not specified)
Translation Model	Choose between different translation models

Project Structure 📂

Whispa_App/
├── src/                  # Source code
│   └── whispa_app/       # Core modules
│       ├── assets/       # Icons
│       ├── ui/          # GUI components  
│       └── *.py         # Functionality
├── installer/            # Inno Setup script
└── Releases/            # Windows installers

Contributing 🤝

• Fork the repository
• Create feature branch:

  git checkout -b feature/new-feature
  

• Commit changes:

  git commit -m "Add awesome feature"
  

• Push to branch:

  git push origin feature/new-feature
  

• Open a Pull Request

Note: Include tests for new features!

License 📄

MIT License - Full Text
Copyright © 2025 Damilare Eniolabi

Acknowledgments 🙏

• OpenAI Whisper models
• MarianMT translation framework
• Hugging Face Transformers library
• CustomTkinter for modern GUI
• SacreMoses for text processing

Report Issues • Contact