Metadata-Version: 2.4
Name: vox-orpheus
Version: 0.1.2
Summary: Orpheus TTS adapter for Vox
Requires-Python: >=3.11
Requires-Dist: numpy<2.4,>=1.26.0
Requires-Dist: vox-runtime>=0.2.2
Description-Content-Type: text/markdown

# vox-orpheus

`vox-orpheus` provides a Vox TTS adapter for Orpheus.

Adapters:

- `orpheus-tts-vllm` - Orpheus medium 3B backend through vLLM

## Install

```bash
pip install vox-orpheus
```

## Runtime Dependencies

The adapter package is intentionally light. The `orpheus-speech` backend and
its vLLM/SNAC runtime dependencies are installed on demand into the isolated
target runtime `$VOX_HOME/runtime/orpheus`.

During `vox pull`, the adapter verifies or installs the Orpheus runtime without
loading model weights. Model weights remain in the normal Vox model store.

## Use with Vox

```bash
vox pull orpheus-tts-vllm:medium-3b
vox run orpheus-tts-vllm:medium-3b "Hello from Orpheus" --voice tara
```

The current Orpheus backend is vLLM-based and is classified for Linux x86_64
CUDA runtimes. CPU and Spark/ARM NVIDIA execution are not currently supported
by this adapter because the `orpheus-speech`/vLLM runtime is not packaged as a
portable CPU or ARM NVIDIA backend.
