Initial standalone vox TTS server extracted from the ttstoy bot cog

Self-contained HTTP service with engine, data, start script, systemd unit, and documentation. Runs independently of the Discord bot on its fixed port.
2026-09-14 14:31:16 -05:00
commit b459533770
913 changed files with 352 additions and 0 deletions
@@ -0,0 +1,38 @@
+# Installing the VOX TTS Server as a system service
+
+These steps install the server as a systemd service that starts on boot and
+restarts automatically if it crashes. Commands that need root are shown with
+`sudo`; run them in your own terminal.
+
+## 1. Install prerequisites
+
+The server uses only the Python standard library.
+
+```bash
+sudo apt install python3
+```
+
+## 2. Install the systemd unit
+
+```bash
+sudo cp /home/owen/vox-tts-server/vox-tts-server.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable --now vox-tts-server
+```
+
+## 3. Verify
+
+```bash
+systemctl status vox-tts-server
+curl -s http://127.0.0.1:33003/health
+```
+
+The health endpoint should return `ok`.
+
+## Managing the service
+
+```bash
+sudo systemctl restart vox-tts-server
+sudo systemctl stop vox-tts-server
+journalctl -u vox-tts-server -f
+```