Installation

Requirements

EasyTranscribe requires Python 3.8 or higher and works on Windows, macOS, and Linux.

The easiest way to install EasyTranscribe is from PyPI using pip:

pip install easytranscribe

If you want the latest development version or want to contribute to the project:

Clone the repository:

git clone https://github.com/akhshyganesh/easytranscribe.git
cd easytranscribe

Or install with development dependencies:

pip install -e ".[dev]"

On macOS, you may need to install PortAudio for audio capture:

brew install portaudio

Install audio development libraries:

sudo apt-get update
sudo apt-get install portaudio19-dev python3-pyaudio

sudo yum install portaudio-devel
# or for newer versions:
sudo dnf install portaudio-devel

On Windows, the audio dependencies are typically included with the pip installation. If you encounter issues, try:

pip install pipwin
pipwin install pyaudio

Verify your installation by running:

easytranscribe --version

You should see output similar to:

easytranscribe 0.1.1

EasyTranscribe will automatically download Whisper models on first use. The available models are:

Model	Size	Speed	Accuracy
tiny	39 MB	Fastest	Good
base	74 MB	Fast	Better
small	244 MB	Medium	Good
medium	769 MB	Slow	Better
large	1550 MB	Slowest	Best
turbo	805 MB	Fast	Best

The base model is used by default as it provides a good balance of speed and accuracy.

If you get a permission denied error when trying to access the microphone:

macOS: Grant microphone permissions to your terminal application in System Preferences > Security & Privacy > Privacy > Microphone
Linux: Make sure your user is in the audio group: sudo usermod -a -G audio $USER
Windows: Ensure microphone privacy settings allow desktop applications to access the microphone

If you encounter audio device errors, list available devices:

import sounddevice as sd
print(sd.query_devices())

If you encounter issues during installation:

Use virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install easytranscribe

If you're still having trouble: