From dfb55a4f3fd958ba965937cd5e269a356962b00d Mon Sep 17 00:00:00 2001
From: timmy <timmy@stackchain.ai>
Date: Wed, 8 Jul 2026 19:27:06 +0000
Subject: [PATCH] seed repo scaffold

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b19bfdb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# live-wizard
+24/7 live TikTok wizard. ponytail build: thin glue + best-in-class OSS + Dockerfiles.
+
+## run it
+```bash
+cp persona/voice-sample.wav persona/avatar.png .env # optional
+docker compose up brain tts avatar-cpu router
+```
+
+## persona
+Edit `persona/persona.yaml` to change the wizard character without changing code.
+
+## services
+- `brain`: Ollama + model
+- `tts`: Coqui XTTS / F5-TTS with cloned voice
+- `avatar-cpu`: Wav2Lip on CPU for prototypes
+- `router`: audio loop + RTMP + TikTok Live connector
\ No newline at end of file