chore: change DECTalk port to 33001, Morshu port to 33002, add AI context file

2026-06-09 10:47:06 -05:00
parent ee3c452670
commit f13b88ab82
10 changed files with 88 additions and 36 deletions
@@ -0,0 +1,52 @@
+# scrapyard-cogworks
+
+## Overview
+Red-DiscordBot cog pack for Kingston's Scrapyard Discord server. Primary cog is **ttstoy** — a multi-engine TTS system with Discord integration, web UI, and Minecraft mod support.
+
+## Cogs
+
+### ttstoy
+Multi-engine TTS cog with Discord slash commands, web UI, and Minecraft server integration.
+
+**TTS Engines:**
+- `chatterbox` — AI voice synthesis via Chatterbox API (port 8099)
+- `clone` — Voice cloning from reference audio
+- `dectalk` — DECTalk retro TTS server (port 33001)
+- `vox` — Half-Life VOX concatenative speech
+- `morshu` — Morshuspeak meme TTS server (port 33002)
+- `minimax` — MiniMax cloud TTS API
+
+**Key components:**
+- `ttstoy.py` — Main cog (~150KB): Discord commands, queue system, voice management, guild config
+- `webui/app.py` — Flask web UI for browser-based TTS with login system
+- `dectalk-server/` — Node.js DECTalk wrapper (Express, port 33001)
+- `morshu-server/server.py` — Python HTTP server for Morshuspeak (port 33002)
+- `morshutalk_engine.py` — Audio concatenation engine for Morshu voice
+- `vox_engine.py` — Half-Life VOX word concatenation
+- `vox_words/`, `vox2_words/` — VOX audio sample packs
+
+**Web UI features:**
+- User login via Discord token (issued by bot command `[p]ttstoy login`)
+- Voice management (predefined + personal voices)
+- Minecraft `/tts` integration via `/api/mc/tts` proxy endpoint
+- DECTalk page with server status
+
+### autoroom
+Auto voice channel creation/management cog (fork of PCXCogs AutoRoom).
+
+## Architecture
+```
+Discord user → [p]ttstoy commands → ttstoy.py → Chatterbox API (port 8099)
+Web UI user  → webui/app.py       → ttstoy.py → Chatterbox API / DECTalk (33001) / Morshu (33002)
+Minecraft    → mod → webui /api/mc/tts         → Chatterbox API / DECTalk / Morshu
+```
+
+## Related Repositories
+- `http://192.168.0.200:3000/kingston/chatterbox-ttstoy-api` — Chatterbox TTS API server
+- `http://192.168.0.200:3000/kingston/minecraft-tts-server-mod` — NeoForge Minecraft TTS mod
+
+## Tech Stack
+- Python 3.10+, Red-DiscordBot (discord.py)
+- Flask (web UI)
+- Node.js/Express (DECTalk server)
+- pydub, librosa (audio processing)