Initial commit: OpenAI-compatible Piper TTS proxy

README.md

@@ -0,0 +1,43 @@
+# piper-openai-proxy
+
+OpenAI-compatible TTS API proxy for [Piper](https://github.com/rhasspy/piper) via the [Wyoming protocol](https://github.com/rhasspy/wyoming).
+
+Any tool that speaks the OpenAI `/v1/audio/speech` API can use your local Piper instance without modification.
+
+## Usage
+
+```bash
+python3 server.py
+```
+
+Environment variables:
+- `PIPER_HOST` — Piper Wyoming host (default: `192.168.86.11`)
+- `PIPER_PORT` — Piper Wyoming port (default: `10200`)
+- `LISTEN_PORT` — Proxy listen port (default: `8951`)
+
+## API
+
+```bash
+# Generate speech
+curl -X POST http://localhost:8951/v1/audio/speech \
+  -H "Content-Type: application/json" \
+  -d '{"input": "Hello world"}' \
+  -o speech.wav
+
+# Health check
+curl http://localhost:8951/health
+```
+
+## Requirements
+
+- Python 3.8+
+- No dependencies (stdlib only)
+- A running [Piper Wyoming server](https://github.com/rhasspy/wyoming-piper)
+
+## How it works
+
+The proxy translates OpenAI TTS API requests into Wyoming protocol messages over a raw TCP socket. Piper generates the audio, and the proxy wraps the raw PCM in a WAV container and returns it.
+
+## License
+
+MIT