Interactive Stories
Craft branching, AI-powered narratives. Write a premise, generate an opening scene, then explore a tree of story nodes by choosing one of three branches (A/B/C) at every step. Each path is saved to disk so you can revisit and continue any branch later.
Interactive Stories Example Sessions
Interactive Stories Documentation
# π Interactive Stories
> **Transform your story ideas into immersive, branching adventures with AI-powered narration, illustrations, and music!**
Welcome to **Interactive Stories**, an AI-driven "Choose Your Own Adventure" reader and story generator. Whether you want to explore a rain-soaked cyberpunk mystery, escape an enchanted labyrinth, or sail space winds in search of galactic treasures, Interactive Stories brings your imagination to lifeβcomplete with dynamic narrative paths, bespoke visual illustrations, spoken audio narration, and read-along text highlighting.
---
## β¨ Key Features
- π§ **Endless Branching Narratives**
Start with a simple prompt or premise, and watch the story unfold. Every decision you make crafts a new, unique branch in your adventure tree.
- πΌοΈ **AI-Generated Story Illustrations**
Bring key story moments to life visually! Generate striking custom artwork for any scene or enable automatic generation as you explore.
- ποΈ **Narrated Audio & Ambient Sound**
Listen to your adventure as audio narration and music ambiance are generated for each chapter.
- π **Read Aloud with Synchronized Highlighting**
Listen using built-in browser voice narration while watching the text highlight sentence-by-sentence in real timeβperfect for relaxing or following along.
- βΆ **Immersive Reader Mode**
Distraction-free reading at the push of a button. Focus entirely on the story and visuals with cinema-style immersive viewing.
- π¨ **On-Demand Visual Styling**
Want a neon-glowing cyberpunk vibe, a classic parchment look, or larger buttons for mobile? Tell the style assistant how you want the app to look, and watch the theme transform!
---
## π How to Use Interactive Stories
### 1. Pitch Your Premise
In the **Story Idea** section, enter a short prompt describing your setting, characters, or main conflict.
> *Example: "A weary space farer discovers a glowing, abandoned station orbiting a forgotten star..."*
Click **πΎ Save Idea**, then hit **β¨ Begin Story**!
### 2. Read & Explore
Once your opening chapter is generated, read through the text and inspect the choices presented at the bottom:
- Click **Choice A**, **Choice B**, or **Choice C** to forge ahead down a new path.
- Look at the **Story Tree** on the left or top to revisit previously explored branches or jump back to key decision points anytime.
### 3. Generate Media & Read Along
- **Read Aloud:** Click the **π Read Aloud** button to hear the chapter spoken aloud with real-time text highlighting. Turn on **Auto-read on load** so new scenes start reading automatically!
- **Generate Image:** Click **πΌ Generate Image** to create a fresh illustration for the current node.
- **Generate Audio:** Click **π Generate Audio** to produce rich, atmospheric spoken narration and background audio.
### 4. Dive Into Immersive Mode
Press **F** on your keyboard or click the fullscreen icon (**βΆ**) on the current node card to hide clutter and enjoy a full-screen storybook experience. Press **Esc** or click **β** when you're ready to return.
### 5. Customize the Visual Theme
Scroll down to **π¨ Update Stylesheet**, type a description of the design or look you want (e.g., *"Use a dark, starry night background with glowing teal highlights and rounded cards"*), and click **π Update Stylesheet**. Reload the page to enjoy your personalized design!
---
## π οΈ Helpful Tips & Shortcuts
- **Keyboard Shortcut (`F`):** Toggle Immersive Reader mode instantly when viewing a story chapter.
- **Auto-Image / Auto-Audio:** Enable these checkboxes in the chapter toolbar if you want new images and audio generated automatically whenever you unlock a new choice!
- **AI Model Customization:** Advanced users can expand the **π€ AI Models** section to select specific AI models for storytelling, speed, artwork generation, or voice audio.
---
*Happy storytelling! Where will your adventure take you today?*