Hello Vibe Story Mixer

A playful desktop studio where students assemble characters from Markdown bios, set a scene, and let OpenAI improvise the dialogue.

Getting Started

1. Install dependencies

   pip install -r requirements.txt

2. Create your cast
   • Drop Markdown files into the characters/ folder. Each file's name becomes the character name.
   • Describe the character's voice, quirks, and backstory in the file body.
3. Launch the mixer

   python main.py

4. Generate scenes
   • Select your characters.
   • Describe the scene setting and the conflict spark.
   • Choose how many turns of dialogue to generate.
   • Provide your OpenAI API key (or set the OPENAI_API_KEY environment variable) and press Roll Scene!

Scenes are saved to the scenes/ directory with speaker labels so you can revisit them later.