pywhispercpp

library1.4.1pypypi✓ verified 82d ago

Python bindings for whisper.cpp, providing fast and easy-to-use speech-to-text with support for various backends (CPU, CUDA, Vulkan, OpenVINO, CoreML). Current version 1.4.1, active development with monthly releases.

ai-ml llm-agents

pip install pywhispercpp

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · PYWHISPERCPP

pywhispercpp

ai-mlpythonv1.4.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Model

✓ import pywhispercpp

✗ from pywhispercpp import Model

Basic transcription example.

from pywhispercpp import Model model = Model('ggml-base.en.bin', n_threads=4) segments = model.transcribe('audio.wav') for segment in segments: print(f"[{segment.t0/100:.2f}s -> {segment.t1/100:.2f}s] {segment.text}")

Debug

Known issues

breakingIn v1.1.3, the model path must be a string (not bytes) to avoid segmentation faults.

fix

Ensure model_path is a str in newer versions.

affects: <=1.1.2

gotchaGIL is released during inference; do not call model methods from multiple threads without proper synchronization.

fix

Use locks if calling from multiple threads.

affects: >=1.3.2

deprecatedThe old import path `import whispercpp` is deprecated and may be removed in future versions.

fix

Use `from pywhispercpp import Model` instead.

affects: >=1.0

Upgrade

Version history

1.4.1latest on PyPI · released Dec 30, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

27 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/absadiki/pywhispercpp ↗

packagehttps://pypi.org/project/pywhispercpp/ ↗

docshttps://absadiki.github.io/pywhispercpp/ ↗