Initial spec for Sagaphone

Pulled from Notion project docs: overview, architecture, data model,
event system, line logic, and implementation notes for the family-tree
generator + TTS narrator.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Tim Otlik 2026-07-17 22:04:33 +02:00
commit 06df9df339
7 changed files with 804 additions and 0 deletions

20
README.md Normal file
View file

@ -0,0 +1,20 @@
# Sagaphone
A web-based, procedural family-saga narrator with TTS — generates random
family trees and narrates their story out loud. Intended as a "fall asleep"
tool: set a timer, and it reads family sagas until time runs out.
See [SPEC.md](SPEC.md) for the full spec, architecture, and design areas.
## Status
Spec-only. Implementation not started yet.
## Stack (planned)
- Frontend: SvelteKit
- Backend: FastAPI (Python, `uv`)
- TTS: Piper (server-side)
- Narration: Anthropic Haiku API (server-side)
- Reverse proxy: Caddy
- Deployment target: Zeus, `sagaphone.orbitstack.casa`