Metadata-Version: 2.4
Name: vocalyx
Version: 0.2.1
Summary: Real-time voice assistant with STT, GPT, and TTS. Install with pip install vocalyx. Run vocalyx-stt, vocalyx-tts, and vocalyx.
Author: Daxrajsinh Jadeja
License-Expression: MIT
Project-URL: Homepage, https://github.com/HolboxAI/Voice-to-Voice.git
Project-URL: Repository, https://github.com/HolboxAI/Voice-to-Voice.git
Keywords: voice,assistant,stt,tts,speech-to-text,text-to-speech,realtime,soprano
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: RealtimeSTT>=0.3.0
Requires-Dist: soprano-tts>=0.2.0
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: websockets>=12.0
Requires-Dist: PyAudio>=0.2.14
Requires-Dist: colorama>=0.4.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: scipy>=1.10.0
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Dynamic: license-file

# Vocalyx

Real-time voice assistant with Speech-to-Text, GPT, and Text-to-Speech (Soprano TTS).

## Install

```bash
pip install vocalyx
```

## Project structure

All components live in the `vocalyx` package:

- `vocalyx/tts_server` – TTS WebSocket server (Soprano + GPT streaming)
- `vocalyx/stt_server` – STT WebSocket server (RealtimeSTT)
- `vocalyx/client` – Voice assistant client connecting STT and TTS

## Usage

Run in three terminals:

```bash
# Terminal 1
vocalyx-stt

# Terminal 2
vocalyx-tts

# Terminal 3
vocalyx
```

Create a `.env` file with `OPENAI_API_KEY` for GPT streaming.

## Requirements

- Python 3.10+
- `portaudio`, `ffmpeg` (system dependencies)
- Microphone and audio output

## License

MIT
