Interactive Story Generator

Create Engaging AI-Powered Stories

2024-12-14.16-24-38.mp4

✨ Features

🤝 Interactive AI Collaboration

Craft unique stories through natural dialogue with an advanced AI storyteller. Our system adapts to your input and helps develop engaging narratives that bring your ideas to life.

🎨 Rich Story Customization

Choose from diverse themes like adventure, mystery, romance, and more. Fine-tune your narrative style from fantasy to sci-fi, ensuring each story matches your creative vision.

👤 Dynamic Character Creation

Build compelling characters using expert-designed templates or create your own from scratch. Develop rich personalities that drive your story forward.

⚙️ Advanced Story Controls

Take full control of your narrative with adjustable parameters for creativity, coherence, and story length. Shape the storytelling experience exactly how you want it.

💾 Story Management

Never lose your creative work with built-in story saving and management features. Easily revisit and continue your narratives at any time.

🛠️ Tech Stack

🚀 Getting Started

Installation Guide

Prerequisites

• Python 3.8 or higher
• A Hugging Face API token

Setup Steps

1. Clone the repository:

git clone https://github.com/ChanMeng666/interactive-story-generator.git
cd interactive-story-generator

2. Install dependencies:

pip install -r requirements.txt

3. Create a .env file and add your Hugging Face API token:

HF_TOKEN=your_token_here

4. Run the application:

python app.py

The application will be available at http://localhost:7860

💡 Usage Guide

How to Create Your Story

1. Choose Your Theme

   • Select from multiple story themes and styles
   • Customize the narrative tone to match your vision

2. Set Up Characters

   • Pick from character templates or create custom ones
   • Define personality traits and backgrounds

3. Begin Your Story

   • Describe your initial scene
   • Click "Start Story" to begin the AI collaboration

4. Develop the Narrative

   • Interact with the AI to progress the story
   • Guide the plot development through natural dialogue

5. Fine-tune Generation

   • Adjust creativity settings (Temperature: 0.1-2.0)
   • Control story length (Max Tokens: 64-1024)
   • Modify narrative diversity (Top-p: 0.1-1.0)

6. Save Your Work

   • Export your story at any time
   • Continue previous stories seamlessly

🔧 Advanced Configuration

Generation Parameters

Temperature

Controls creativity level (0.1-2.0):

• Higher values (>1.0) produce more creative, varied output
• Lower values (<1.0) generate more focused, consistent content

Max Tokens

Adjusts response length (64-1024):

• Higher values allow for longer story segments
• Lower values create more concise responses

Top-p (Nucleus Sampling)

Fine-tunes output diversity (0.1-1.0):

• Higher values increase response variety
• Lower values make outputs more deterministic

📝 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Gradio
• Powered by Hugging Face
• Uses Meta's Llama model

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🙋‍♀ Author

Created and maintained by Chan Meng.