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-cli

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

Release files for whisper.cpp-cli 0.0.3

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.3
File	Size	Uploaded
whisper_cpp_cli-0.0.3.tar.gz	5.5 kB	May 1, 2024	Details

Built distributions (wheels)

Table of built distributions (wheels) for whisper.cpp-cli 0.0.3
File	Interpreter	ABI	Platform	Reset
whisper_cpp_cli-0.0.3-py3-none-win_amd64.whl 364.1 kB May 1, 2024	Python 3	none	Windows x86-64	Details
whisper_cpp_cli-0.0.3-py3-none-win32.whl 300.2 kB May 1, 2024	Python 3	none	Windows x86-32	Details
whisper_cpp_cli-0.0.3-py3-none-musllinux_1_1_x86_64.whl 1.1 MB May 1, 2024	Python 3	none	Linux musl 1.1+ x86-64	Details
whisper_cpp_cli-0.0.3-py3-none-musllinux_1_1_ppc64le.whl 1.3 MB May 1, 2024	Python 3	none	Linux musl 1.1+ PowerPC 64-le	Details
whisper_cpp_cli-0.0.3-py3-none-musllinux_1_1_i686.whl 1.2 MB May 1, 2024	Python 3	none	Linux musl 1.1+ x86-32	Details
whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 589.0 kB May 1, 2024	Python 3	none	Linux glibc 2.17+ x86-64	Details
whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl 714.8 kB May 1, 2024	Python 3	none	Linux glibc 2.17+ PowerPC 64-le	Details
whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl 631.0 kB May 1, 2024	Python 3	none	Linux glibc 2.17+ x86-32	Details
whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 569.7 kB May 1, 2024	Python 3	none	Linux glibc 2.17+ ARM64	Details
whisper_cpp_cli-0.0.3-py3-none-macosx_11_0_arm64.whl 523.1 kB May 1, 2024	Python 3	none	macOS 11.0+ ARM64	Details
whisper_cpp_cli-0.0.3-py3-none-macosx_10_12_x86_64.whl 599.0 kB May 1, 2024	Python 3	none	macOS 10.12+ x86-64	Details

Total release size: 7.9 MB

Release files / whisper_cpp_cli-0.0.3.tar.gz

Download URL	whisper_cpp_cli-0.0.3.tar.gz
Size	5.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`59b8f63af2126a46fb997f53cdfd9222539bf759c7ed623d998eba47f7629712`
BLAKE2b-256 checksum How to use checksums	`1abedc766c7d1a009f97a445e1db654f3dc8c68d363b94b955ac954949d35566`
Upload date	May 1, 2024
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.3-py3-none-win_amd64.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-win_amd64.whl
Size	364.1 kB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`b1d2005fc60c967670254614f4c21f37277e25d75c0d670d61f3ad409d53abe1`
BLAKE2b-256 checksum How to use checksums	`8d9e5d0ae83e7e42a9e3305d6de22008a7375721fcfc025cd81836fb6cd09678`
Upload date	May 1, 2024
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.3-py3-none-win32.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-win32.whl
Size	300.2 kB
Tags	Python 3 Windows x86-32
SHA-256 checksum How to use checksums	`a49118045d3db4af5fdc3c249c8ca648ab73f1c038ccecd4a7590099d6c13b03`
BLAKE2b-256 checksum How to use checksums	`0b78c6693cad9679e055ed0417e3cd8f97fd1f621d27e0fe0ea2501fbf7eb755`
Upload date	May 1, 2024
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.3-py3-none-musllinux_1_1_x86_64.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-musllinux_1_1_x86_64.whl
Size	1.1 MB
Tags	Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum How to use checksums	`5ff95d91321496ada747ccb13feb873fd7789639f082fc42f86a7179f8822e73`
BLAKE2b-256 checksum How to use checksums	`a1ee2e57ee256cecc1c1812706e872b82e59b07f0cfb4748a04131ed1842555b`
Upload date	May 1, 2024
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.3-py3-none-musllinux_1_1_ppc64le.whl

Download URL	whisper_cpp_cli-0.0.3-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	`ca388e49aaf3ac69e7cc5f49564d7c4f4d31d1a2c5e9d4138d5e23291e0a22dd`
BLAKE2b-256 checksum How to use checksums	`84f950e2cf8b6dd86878b8a786d8df59976a3622d1e4a9bb9c8c564a9b337d48`
Upload date	May 1, 2024
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.3-py3-none-musllinux_1_1_i686.whl

Download URL	whisper_cpp_cli-0.0.3-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	`72190ff79a831fe19dd6f0e1f9b07e3717a6cac284a39d5d84875f3ebf229f83`
BLAKE2b-256 checksum How to use checksums	`fb9b7f88d4dbf2556af0c7b18c3b5a1f1a00867a3d6e723d5499d556d1c0aeb6`
Upload date	May 1, 2024
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.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	589.0 kB
Tags	Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum How to use checksums	`03133be9568117a85d4d8daedd7fe8469807d10d2fe92e0e177d2fcb5147808f`
BLAKE2b-256 checksum How to use checksums	`cd1481dc2f85743343286756825312919ff6e29b61d4cd7457c32fc972d77d0f`
Upload date	May 1, 2024
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.3-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Size	714.8 kB
Tags	Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum How to use checksums	`917fdb870811a4f19ccb6677ca60e97bc32502c5adaacd20f63f4a3fe6d761c7`
BLAKE2b-256 checksum How to use checksums	`eba6794ae34029bdcecf25c49f8017661c8645d0d0c79d983f5d188faa2287d9`
Upload date	May 1, 2024
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.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Size	631.0 kB
Tags	Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum How to use checksums	`17fa2feb3b0af9a13cc56089d5d52226b93fedf1567545a1da4d6958ccd808b3`
BLAKE2b-256 checksum How to use checksums	`95f4065c3b22068842486b792092323c49532f00556368a60c23e885ced95745`
Upload date	May 1, 2024
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.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	569.7 kB
Tags	Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum How to use checksums	`6f5c4950690188cb8ca4e33affc63c659e01accdbdad13dbbbdcde16a4e91c05`
BLAKE2b-256 checksum How to use checksums	`2b5a44515c53e5ea7434568c3bf3cbd44e29cb377ed2611b70a9b0023f961f7e`
Upload date	May 1, 2024
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.3-py3-none-macosx_11_0_arm64.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-macosx_11_0_arm64.whl
Size	523.1 kB
Tags	Python 3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`6c9cb1d10770da5b7f92c54c2ace29142694b5b392c274db1d95ce1d2f6223d2`
BLAKE2b-256 checksum How to use checksums	`fdeb4d1a96d887b62fdddc58e3e0c9c94f673b54cd9fc025329340f9c4d052bc`
Upload date	May 1, 2024
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.3-py3-none-macosx_10_12_x86_64.whl

Download URL	whisper_cpp_cli-0.0.3-py3-none-macosx_10_12_x86_64.whl
Size	599.0 kB
Tags	Python 3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`1d85c6ca3dbf907c07a59f8daa620b3d0e3b263356c5220357dd7e06b42bc523`
BLAKE2b-256 checksum How to use checksums	`a511359833bd72353eb0142defc26ac2d8bd957da5b72540bd546ce7f0caea83`
Upload date	May 1, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/5.0.0 CPython/3.12.3`