Metadata-Version: 2.1
Name: voice-stream
Version: 0.3.6
Summary: A streaming library for creating voice bots using LLMs.  Connects LLMs to speech recognition and speech synthesis APIs.
Home-page: https://github.com/DaveDeCaprio/voice-stream
License: MIT
Keywords: voicebot,genai,twilio,llm
Author: Dave DeCaprio
Author-email: daved@alum.mit.edu
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Conferencing
Classifier: Topic :: Communications :: Telephony
Classifier: Topic :: Multimedia :: Sound/Audio :: Capture/Recording
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Provides-Extra: google
Provides-Extra: openai
Provides-Extra: quart
Provides-Extra: quickstart
Provides-Extra: twilio
Requires-Dist: aiofiles (>=23.2.1,<24.0.0)
Requires-Dist: fastapi (>=0.108.0,<0.109.0) ; extra == "quickstart"
Requires-Dist: google-cloud-speech (>=2.23.0) ; extra == "google"
Requires-Dist: google-cloud-texttospeech (>=2.15.0) ; extra == "google"
Requires-Dist: langchain (>=0.0.353)
Requires-Dist: langchain-google-genai (>=0.0.5) ; extra == "google"
Requires-Dist: mutagen (>=1.47.0,<2.0.0)
Requires-Dist: openai (>=1.6.1) ; extra == "openai" or extra == "quickstart"
Requires-Dist: pyaudio (>=0.2.14,<0.3.0)
Requires-Dist: pydantic (>=2.5.3)
Requires-Dist: quart (>=0.19.4) ; extra == "quart"
Requires-Dist: speechrecognition (>=3.10.1,<4.0.0) ; extra == "quickstart"
Requires-Dist: tiktoken (>=0.5.2) ; extra == "openai"
Requires-Dist: twilio (>=8.11.0) ; extra == "twilio"
Requires-Dist: vosk (>=0.3.45,<0.4.0) ; extra == "quickstart"
Project-URL: Documentation, https://voice-stream.readthedocs.io/
Project-URL: Repository, https://github.com/DaveDeCaprio/voice-stream
Description-Content-Type: text/markdown

# voice-stream: Creating voice bots from LLMs.

![PyPI](https://img.shields.io/pypi/v/voice-stream)
[![Tests](https://github.com/DaveDeCaprio/voice-stream/actions/workflows/tests.yaml/badge.svg)](https://github.com/DaveDeCaprio/voice-stream/actions/workflows/tests.yaml)
[![Documentation Status](https://readthedocs.org/projects/voice-stream/badge/?version=latest)](https://voice-stream.readthedocs.io/en/latest/?badge=latest)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
![Python Versions](https://img.shields.io/pypi/pyversions/voice-stream)
[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)

<!-- start elevator-pitch -->

VoiceStream is a framework for building voice bots using language models.  

   * Integrates with LangChain so you can take any LLM application.
   * Makes it easy to use different TTS and Speech Recognition models
   * Uses asyncio and streaming throughout to provide a great user experience.
   * Handles voice specific conversation flows, like interrupting the current speaker.

<!-- end elevator-pitch -->

<!-- start install -->

## Install

VoiceStream is distributed on [PyPI].  To install, run:

   ```text
   pip install voice-stream
   ```

This will install the bare minimum requirements of VoiceStream.
A lot of the value of VoiceStream comes when integrating it with different audio sources, speech recognition and
text to speech systems.  By default, the dependencies needed to do that are NOT installed. You will need to install 
the dependencies for specific integrations separately.

[pypi]: https://pypi.org/project/voice-stream/
<!-- end install -->

## Contributing

VoiceStream is a volunteer maintained open source project, and we welcome contributions of all forms. Please take a look at our [Contributing Guide](https://voice-stream.readthedocs.io/en/latest/contributing/index.html) for more information.

<!-- start license -->
## License

This project is licensed under the [**MIT License**](https://choosealicense.com/licenses/mit/).
<!-- end license -->

