https://github.com/zigai/whisper.cpp.py
Python wrapper around whisper.cpp server
https://github.com/zigai/whisper.cpp.py
whisper whisper-cpp whisper-cpp-python whisper-server whispercpp
Last synced: 7 days ago
JSON representation
Python wrapper around whisper.cpp server
- Host: GitHub
- URL: https://github.com/zigai/whisper.cpp.py
- Owner: zigai
- License: mit
- Created: 2025-09-15T13:02:49.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2026-06-14T23:37:04.000Z (25 days ago)
- Last Synced: 2026-06-15T01:15:31.673Z (25 days ago)
- Topics: whisper, whisper-cpp, whisper-cpp-python, whisper-server, whispercpp
- Language: Python
- Homepage:
- Size: 248 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# whisper.cpp.py
Python wrapper around [whisper.cpp](https://github.com/ggml-org/whisper.cpp) server.
## Installation
This package requires [whisper.cpp](https://github.com/ggml-org/whisper.cpp) to be installed manually.
```bash
uv add "git+https://github.com/zigai/whisper.cpp.py.git"
```
```bash
pip install git+https://github.com/zigai/whisper.cpp.py
```
## Usage
```python
from whispercpppy import WhisperCppServer, WhisperCppServerOptions
opts = WhisperCppServerOptions(model="models/ggml-base.en.bin")
whisper = WhisperCppServer(opts)
transcript = whisper.inference("/path/to/audio/or/video/file")
```
## GGUF model download helper
```text
whispercpp-download --help
usage: whisper-cpp-download [-h] [-d] [-o] [-t] models [models ...]
download whisper.cpp GGUF models
available models:
- tiny
- tiny.en
- tiny-q5_1
- tiny.en-q5_1
- tiny-q8_0
- base
- base.en
- base-q5_1
- base.en-q5_1
- base-q8_0
- small
- small.en
- small.en-tdrz
- small-q5_1
- small.en-q5_1
- small-q8_0
- medium
- medium.en
- medium-q5_0
- medium.en-q5_0
- medium-q8_0
- large-v1
- large-v2
- large-v2-q5_0
- large-v2-q8_0
- large-v3
- large-v3-q5_0
- large-v3-turbo
- large-v3-turbo-q5_0
- large-v3-turbo-q8_0
positional arguments:
models model names
options:
-h, --help show this help message and exit
-d, --dir save directory for models. defaults to the path set by WHISPERCPP_MODELS_DIR env var or the current directory if not set.
-o, --overwrite overwrite the file if it already exists.
-t, --timeout timeout for the download request in seconds
```
## License
[MIT License](https://github.com/zigai/whisper.cpp.py/blob/master/LICENSE)