Automated episode generation for Unity-based 3D cartoon livestreaming.
# Create and activate environment
conda create -n brainwave python=3.11
conda activate brainwave
# Install package
pip install -e .-
Copy
.env.exampleto.envand add your OpenAI API key:OPENAI_API_KEY=sk-... -
Optionally copy
config.example.yamltoconfig.yamlto customize settings.
# Generate a complete episode
brainwave generate --topic "The office WiFi goes down"
# Generate plot preview only (faster, for review before full generation)
brainwave preview --topic "Art discovers cryptocurrency"
# Build TTS audio for an episode
brainwave build <episode-id> # Uses configured TTS provider
brainwave build <episode-id> --mock # Uses placeholder audio for testing
# Batch generate multiple episodes
brainwave batch -n 5
# Export Unity manifest
brainwave export <episode-id>
# List all episodes
brainwave list
# Show episode details
brainwave show <episode-id>src/brainwave/ # Main package
data/ # Character, shot, and voice definitions
templates/ # Jinja2 prompt templates
scenes/ # Generated episodes
placeholders/ # Mock audio files for testing
Configure in config.yaml:
mock- Uses placeholder audio (no API calls)openai- OpenAI TTS APIlocal- Local TTS (requirespip install brainwave[local-tts])