cywhispercpp

Python bindings for whisper.cpp using Cython and scikit-build.

Overview

This project provides Python bindings for the whisper.cpp library, enabling speech recognition capabilities in Python with native performance through Cython integration.

Note: This project is not just for Python developers! C++ developers can also use the pre-built whisper.cpp library included in this package instead of building whisper.cpp from source.

Features

• Python bindings for whisper.cpp speech recognition
• Built with Cython for optimal performance
• CMake integration via scikit-build
• Built-in model downloader with CLI interface
• Test-driven development approach

Installation

pip install cywhispercpp

For the latest development version:

pip install git+https://github.com/MohammadRaziei/whisper-cpp.git

Quick Start

Download Models

# List available models
cywhispercpp models list

# Download a model
cywhispercpp models download tiny

# Download to specific path
cywhispercpp models download base /path/to/models

Python Usage

from cywhispercpp.models import download_model

# Download a model
download_model("tiny")

Development

Run tests:

pytest -n auto

License

MIT License