1- # whispercpp [ ![ CI ] ( https://github.com/aarnphm/whispercpp/actions/workflows/ci.yml/badge.svg?branch=main )] ( https://github.com/aarnphm/whispercpp/actions/workflows/ci.yml )
1+ # whispercpp
22
33_ Pybind11 bindings for
44[ whisper.cpp] ( https://github.com/ggerganov/whisper.cpp.git ) _
55
66## Quickstart
77
8- Install with pip :
8+ Install from source :
99
1010``` bash
11- pip install whispercpp
11+ pip install git+https://github.com/AIWintermuteAI/ whispercpp.git -vv
1212```
13-
14- > NOTE: We will setup a hermetic toolchain for all platforms that doesn't have a
15- > prebuilt wheels, (which means you don't have to setup anything to install the
16- > Python package) which will take a bit longer to install. Pass ` -vv ` to ` pip `
17- > to see the progress.
18-
19- To use the latest version, install from source:
20-
21- ``` bash
22- pip install git+https://github.com/aarnphm/whispercpp.git -vv
23- ```
24-
25- For local setup, initialize all submodules:
13+ Alternatively, git clone the develop branch of repository and initialize all submodules:
2614
2715``` bash
2816git submodule update --init --recursive
2917```
3018
31- Build the wheel:
19+ Then build the wheel:
3220
3321``` bash
3422# Option 1: using pypa/build
@@ -38,7 +26,7 @@ python3 -m build -w
3826./tools/bazel build //:whispercpp_wheel
3927```
4028
41- Install the wheel:
29+ Afterwards, install the wheel:
4230
4331``` bash
4432# Option 1: via pypa/build
@@ -109,6 +97,19 @@ from whispercpp import api
10997
11098See [ DEVELOPMENT.md] ( ./DEVELOPMENT.md )
11199
100+ ### Official Builds
101+
102+ Build Type | Status | Note
103+ ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------
104+ ** Linux / MacOS Wheels** | [ ![ Status] ( https://github.com/AIWintermuteAI/whispercpp/actions/workflows/wheels.yml/badge.svg?branch=develop )] ( https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-cc.html )
105+ ** Unit tests** | [ ![ Status] ( https://github.com/AIWintermuteAI/whispercpp/actions/workflows/ci.yml/badge.svg?branch=develop )] ( https://github.com/aarnphm/whispercpp/actions/workflows/ci.yml )
106+
107+ ## Examples
108+
109+ See [ examples] ( ./examples ) for more information.
110+
111+ [ ![ You won't believe how fast it is | Raspberry Pi Speech-to-Text] ( https://img.youtube.com/vi/Mfbei9I8qQc/0.jpg )] ( https://www.youtube.com/watch?v=Mfbei9I8qQc )
112+
112113## APIs
113114
114115### ` Whisper `
@@ -204,12 +205,4 @@ See [DEVELOPMENT.md](./DEVELOPMENT.md)
204205- Using ` cdll ` and ` ctypes ` and be done with it?
205206
206207 - This is also valid, but requires a lot of hacking and it is pretty slow
207- comparing to Cython and Pybind11.
208-
209- ## Examples
210-
211- See [ examples] ( ./examples ) for more information
212-
213- python3 -m build -w && pip install dist/* .whl
214- rm -rf src/whispercpp/api_cpp2py_export.so* dist/* && python3 -m build -w && pip install --force-reinstall dist/* .whl
215- python3 examples/stream/stream.py --model_name tiny.en-q5_1
208+ comparing to Cython and Pybind11.
0 commit comments