Metadata-Version: 2.1
Name: whisper-live
Version: 0.0.2
Summary: A nearly-live implementation of OpenAI's Whisper.
Home-page: https://github.com/collabora/WhisperLive
Author: Collabora Ltd
Author-email: vineet.suryan@collabora.com
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyAudio
Requires-Dist: faster-whisper (==0.6.0)
Requires-Dist: torch
Requires-Dist: torchaudio
Requires-Dist: websockets
Requires-Dist: onnxruntime
Requires-Dist: ffmpeg-python
Requires-Dist: scipy
Requires-Dist: websocket-client

# whisper-live
A nearly-live implementation of OpenAI's Whisper.

This project is a real-time transcription application that uses the OpenAI Whisper model to convert speech input into text output. It can be used to transcribe both live audio input from microphone and pre-recorded audio files.

Unlike traditional speech recognition systems that rely on continuous audio streaming, we use [voice activity detection (VAD)](https://github.com/snakers4/silero-vad) to detect the presence of speech and only send the audio data to whisper when speech is detected. This helps to reduce the amount of data sent to the whisper model and improves the accuracy of the transcription output.

## Installation
- Install PyAudio and ffmpeg
```bash
 bash setup.sh
```

- Install whisper-live from pip
```bash
 pip install whisper-live
```

## Getting Started
- Run the server
```python
 from whisper_live.server import TranscriptionServer
 server = TranscriptionServer()
 server.run_server("0.0.0.0", 9090)
```

- On the client side
    - To transcribe an audio file:
    ```python
      from whisper_live.client import TranscriptionClient
      client = TranscriptionClient("localhost", 9090, multilingual=True, language="hi", translate=True)
      client(audio_file_path)
    ```
    This command transcribes the specified audio file (audio.wav) using the Whisper model. It connects to the server running on localhost at port 9090. It also enables the multilingual feature, allowing transcription in multiple languages. The language option specifies the target language for transcription, in this case, Hindi ("hi"). The translate option should be set to `True` if we want to translate from the source language to English and `False` if we want to transcribe in the source language.

    - To transcribe from microphone:
    ```python
      from whisper_live.client import TranscriptionClient
      client = TranscriptionClient(host, port, multilingual=True, language="hi", translate=True)
      client()
    ```
    This command captures audio from the microphone and sends it to the server for transcription. It uses the same options as the previous command, enabling the multilingual feature and specifying the target language and task.


## Transcribe audio from browser
- Run the server
```python
 from whisper_live.server import TranscriptionServer
 server = TranscriptionServer()
 server.run_server("0.0.0.0", 9090)
```
This would start the websocket server on port ```9090```.

### Chrome Extension
- Refer to [Audio-Transcription-Chrome](https://github.com/collabora/whisper-live/tree/main/Audio-Transcription-Chrome#readme) to use Chrome extension.

### Firefox Extension
- Refer to [Audio-Transcription-Firefox](https://github.com/collabora/whisper-live/tree/main/Audio-Transcription-Firefox#readme) to use Mozilla Firefox extension.

## Whisper Live Server in Docker
- Build docker container
```bash
 docker build . -t whisper-live
```

- Run docker container
```bash
 docker run -it --gpus all -p 9090:9090 whisper-live:latest
```

## Future Work
- [ ] Add translation to other languages on top of transcription.
- [ ] TensorRT backend for Whisper.

## Citations
```bibtex
@article{Whisper
  title = {Robust Speech Recognition via Large-Scale Weak Supervision},
  url = {https://arxiv.org/abs/2212.04356},
  author = {Radford, Alec and Kim, Jong Wook and Xu, Tao and Brockman, Greg and McLeavey, Christine and Sutskever, Ilya},
  publisher = {arXiv},
  year = {2022},
}
```

```bibtex
@misc{Silero VAD,
  author = {Silero Team},
  title = {Silero VAD: pre-trained enterprise-grade Voice Activity Detector (VAD), Number Detector and Language Classifier},
  year = {2021},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/snakers4/silero-vad}},
  commit = {insert_some_commit_here},
  email = {hello@silero.ai}
}
