Skip to main content

whisper.cpp-cli

A Python wrapper around the whisper.cpp CLI.

Packages whisper.cpp into pre-built, pip-installable wheels, for macOS and Linux.

Installation

Available on PyPI, with pre-built wheels for macOS and Linux:

pip install whisper.cpp-py

Once installed, whisper-cpp will be exposed as a command-line tool:

whisper-cpp --help

Usage

Following Simon Willison's Transcribing MP3s with whisper-cpp on macOS, once installed, you can download a Whisper model file:

curl -o ggml-large-v3-q5_0.bin -L 'https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-q5_0.bin?download=true'

Convert from MP3 to 16kHz WAV, if necessary:

ffmpeg -i input.mp3 -ar 16000 input.wav

And transcribe audio, as follows:

whisper-cpp -m ggml-large-v3-q5_0.bin input.wav --output-txt

Development

whisper.cpp is compiled without any CPU or GPU acceleration.

In the future, I'd like to distribute builds with Core ML support, CUDA support, and more, given whisper.cpp's own support for these features.

The latest release compiles against v1.5.5.

License

MIT

Metadata

Release files for whisper.cpp-cli 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for whisper.cpp-cli 0.0.1
File Size Uploaded Provenance Actions
whisper_cpp_cli-0.0.1.tar.gz 6.1 kB Without provenance Details for whisper_cpp_cli-0.0.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for whisper.cpp-cli 0.0.1
File Actions
whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_x86_64.whl Python 3 none Linux musl 1.1+ x86-64 Details for whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_x86_64.whl
whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_s390x.whl Python 3 none Linux musl 1.1+ IBM System/390x Details for whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_s390x.whl
whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_ppc64le.whl Python 3 none Linux musl 1.1+ PowerPC 64-le Details for whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_ppc64le.whl
whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_i686.whl Python 3 none Linux musl 1.1+ x86-32 Details for whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_i686.whl
whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl Python 3 none Linux glibc 2.17+ IBM System/390x Details for whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details for whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details for whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
whisper_cpp_cli-0.0.1-py3-none-macosx_14_0_arm64.whl Python 3 none macOS 14.0+ ARM64 Details for whisper_cpp_cli-0.0.1-py3-none-macosx_14_0_arm64.whl
whisper_cpp_cli-0.0.1-py3-none-macosx_13_0_x86_64.whl Python 3 none macOS 13.0+ x86-64 Details for whisper_cpp_cli-0.0.1-py3-none-macosx_13_0_x86_64.whl

Total release size: 9.9 MB

Release files / whisper_cpp_cli-0.0.1.tar.gz

Download URL whisper_cpp_cli-0.0.1.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
d8e7caf64af4d2eff4651bb09cf273f03b0d208b6611be1a4366e4702d98e062
BLAKE2b-256 checksum
How to use checksums
dc6fff7b60f10e6bc85a01d8cd5c5980e8269185e6745e0c6d800b0d799d7428
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_x86_64.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_x86_64.whl
Size 1.2 MB
Tags Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum
How to use checksums
67ac10b18db4b65855da499b13754478fd9a66d225a56c3c7b08e750ca05f335
BLAKE2b-256 checksum
How to use checksums
46f6d0b2d9aff90077e8472412bec99943fc429f9dce37fcdc088455527b9880
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_s390x.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_s390x.whl
Size 1.4 MB
Tags Linux musl 1.1+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
f985c8d73b4e6fefc3bea7f3272109fe42d77345888ff2f7f7a1ed9cae73dd08
BLAKE2b-256 checksum
How to use checksums
053fc52ee3c87cd64807199b4b4d35f8c11f54d80217515779f2d3f27cdf9f35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_ppc64le.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_ppc64le.whl
Size 1.3 MB
Tags Linux musl 1.1+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
103a1c0467f6e0ebbb403f4a70cb275e154febd637449070bba54a3bdf111dc3
BLAKE2b-256 checksum
How to use checksums
65bab637505154a7bbc08207a7b44c1cbcbb817c09a58806481d232c786bf14c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_i686.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-musllinux_1_1_i686.whl
Size 1.2 MB
Tags Linux musl 1.1+ x86-32 Python 3
SHA-256 checksum
How to use checksums
9d792dec3439c372d9119267705df6b54fa0e25fbc646ec9a7417a34c78cb665
BLAKE2b-256 checksum
How to use checksums
6d1602c8ee1d5640810320af983b0a159480ff29c6a229375caa416845d76d34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 640.0 kB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
4f257a2187dad1ace44c2b2ce1abde6105063858e0a0406663b0060c8e97a83f
BLAKE2b-256 checksum
How to use checksums
aa0047b29899e1c05b749e60ac842c848315af51fe597a758f2627e139b7366e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
Size 856.0 kB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
ebab24bcb5e42064747cda8f5bb8a406525d13b70a284d3b91b7d3dc21c5111c
BLAKE2b-256 checksum
How to use checksums
587d659a11094a668a1fdc9ae489776b20cb450cf35eb268057ce6be2cdc0775
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Size 742.5 kB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
0343543eea6bbee3ab7407f64bf6d02b0b9d72c89848d4169bd50bd3a1dd7a2f
BLAKE2b-256 checksum
How to use checksums
7210d0b4ddbbbeb7cf9deab52b095808e5d0cbd5fb6ef9080d6e565b4cfc2fcc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Size 678.9 kB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
5fee0adc6249a3d0db45c1d9a7f1e653ceed1b2434cd860c315d75653a867b40
BLAKE2b-256 checksum
How to use checksums
e960ebe7ce097dc5a521b2f137120334630f6dca4d2516013fbcbf6a5ad71fb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 600.4 kB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
2d62cd940964c19c043cd1e8b17133396af7145a03dfc2a290a552df9ece6691
BLAKE2b-256 checksum
How to use checksums
3cf2b8b3fb51c82617899f15189ca8e852b95dc31f6f63de07205fa3d2700488
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-macosx_14_0_arm64.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-macosx_14_0_arm64.whl
Size 573.8 kB
Tags Python 3 macOS 14.0+ ARM64
SHA-256 checksum
How to use checksums
2203261fc2570e2d39377d16a597adaab98697a85eccf650ebe8dea176ad0721
BLAKE2b-256 checksum
How to use checksums
f52ac6b06c3c8f65887a01d24a2126b5159ee9007eb747d15b2345c8f9e25d68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Release files / whisper_cpp_cli-0.0.1-py3-none-macosx_13_0_x86_64.whl

Download URL whisper_cpp_cli-0.0.1-py3-none-macosx_13_0_x86_64.whl
Size 656.7 kB
Tags Python 3 macOS 13.0+ x86-64
SHA-256 checksum
How to use checksums
06e8a437a398f1207d17765fa0d422ec7f6dfc754640b31d4bc98096835cdf1e
BLAKE2b-256 checksum
How to use checksums
cb8dcdc92ecaac27ff08d989ad453dfc97a9debf5caae1a3b7e2faeb67f7172c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.3

Security for whisper.cpp-cli 0.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page