Skip to content

Commit 843f9fc

Browse files
expanded README
1 parent db0ff09 commit 843f9fc

1 file changed

Lines changed: 20 additions & 27 deletions

File tree

README.md

Lines changed: 20 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,22 @@
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
2816
git 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

11098
See [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

Comments
 (0)