{"id":22847599,"url":"https://github.com/chanmeng666/interactive-story-generator","last_synced_at":"2025-09-13T01:09:43.897Z","repository":{"id":270274452,"uuid":"902121018","full_name":"ChanMeng666/interactive-story-generator","owner":"ChanMeng666","description":"【Join our constellation of stargazers!⭐️】An interactive AI-powered story generator that creates dynamic narratives through collaborative storytelling between users and Meta's Llama model. Built with Gradio for an intuitive UI and leveraging the Hugging Face Inference API.","archived":false,"fork":false,"pushed_at":"2025-07-09T10:38:40.000Z","size":292,"stargazers_count":4,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-09T11:45:20.083Z","etag":null,"topics":["ai","chatbot","gradio","huggingface","interactive","llama","nlp","python","storytelling","text-generation"],"latest_commit_sha":null,"homepage":"https://huggingface.co/spaces/ChanMeng666/interactive-story-generator","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChanMeng666.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"chanmeng66u","thanks_dev":null,"custom":null}},"created_at":"2024-12-12T00:18:01.000Z","updated_at":"2025-07-09T10:38:44.000Z","dependencies_parsed_at":"2024-12-29T23:22:09.750Z","dependency_job_id":"3a5bfcac-7a2e-4956-adb7-c72740bccb4c","html_url":"https://github.com/ChanMeng666/interactive-story-generator","commit_stats":null,"previous_names":["chanmeng666/interactive-story-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ChanMeng666/interactive-story-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Finteractive-story-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Finteractive-story-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Finteractive-story-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Finteractive-story-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChanMeng666","download_url":"https://codeload.github.com/ChanMeng666/interactive-story-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Finteractive-story-generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274903490,"owners_count":25371164,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-12T02:00:09.324Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatbot","gradio","huggingface","interactive","llama","nlp","python","storytelling","text-generation"],"created_at":"2024-12-13T04:08:28.285Z","updated_at":"2025-09-13T01:09:43.883Z","avatar_url":"https://github.com/ChanMeng666.png","language":"Python","funding_links":["https://buymeacoffee.com/chanmeng66u"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n[![Project Banner](./public/interactive-story-generator-logo.svg)](#)\n\n# 🎭 Interactive Story Generator\u003cbr/\u003e\u003ch3\u003eAI-Powered Collaborative Storytelling Platform\u003c/h3\u003e\n\nAn innovative storytelling platform that leverages cutting-edge AI technology to create engaging, interactive narratives.\u003cbr/\u003e\nSupports multiple story genres, dynamic character creation, and real-time collaborative storytelling.\u003cbr/\u003e\nOne-click **FREE** deployment of your personalized story generator.\n\n[Live Demo][demo-site] · [Documentation][docs] · [Issues][github-issues-link] · [Contributing][contributing-guide]\n\n\u003cbr/\u003e\n\n[![🚀 Try It Live 🚀](https://gradient-svg-generator.vercel.app/api/svg?text=%F0%9F%9A%80Try%20It%20Live%F0%9F%9A%80\u0026color=000000\u0026height=60\u0026gradientType=radial\u0026duration=6s\u0026color0=ffffff\u0026template=pride-rainbow)][demo-site]\n\n\u003cbr/\u003e\n\n\u003c!-- SHIELD GROUP --\u003e\n\n[![][github-release-shield]][github-release-link]\n[![][github-stars-shield]][github-stars-link]\n[![][github-forks-shield]][github-forks-link]\n[![][github-issues-shield]][github-issues-link]\n[![][github-license-shield]][github-license-link]\u003cbr/\u003e\n[![][python-shield]][python-link]\n[![][gradio-shield]][gradio-link]\n[![][huggingface-shield]][huggingface-link]\n[![][pytorch-shield]][pytorch-link]\n\n**Share Interactive Story Generator**\n\n[![][share-x-shield]][share-x-link]\n[![][share-linkedin-shield]][share-linkedin-link]\n[![][share-reddit-shield]][share-reddit-link]\n[![][share-telegram-shield]][share-telegram-link]\n\n\u003csup\u003e🌟 Revolutionizing creative storytelling through AI collaboration. Built for writers, creators, and storytelling enthusiasts.\u003c/sup\u003e\n\n\u003c/div\u003e\n\n\u003e [!IMPORTANT]\n\u003e This project demonstrates modern AI-powered storytelling with real-time generation, multiple genre support, and collaborative narrative development. It combines Gradio's intuitive interface with Hugging Face's powerful language models to provide an engaging storytelling experience.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ckbd\u003e📑 Table of Contents\u003c/kbd\u003e\u003c/summary\u003e\n\n#### TOC\n\n- [🎭 Interactive Story GeneratorAI-Powered Collaborative Storytelling Platform](#-interactive-story-generatorai-powered-collaborative-storytelling-platform)\n      - [TOC](#toc)\n      - [](#)\n  - [🌟 Introduction](#-introduction)\n  - [✨ Key Features](#-key-features)\n    - [`1` AI-Powered Story Generation](#1-ai-powered-story-generation)\n    - [`2` Multi-Genre Support](#2-multi-genre-support)\n    - [`3` Dynamic Character Creation](#3-dynamic-character-creation)\n    - [`*` Additional Features](#-additional-features)\n  - [🛠️ Tech Stack](#️-tech-stack)\n  - [🏗️ Architecture](#️-architecture)\n    - [System Architecture](#system-architecture)\n    - [Data Flow](#data-flow)\n  - [🚀 Getting Started](#-getting-started)\n    - [Prerequisites](#prerequisites)\n    - [Quick Installation](#quick-installation)\n    - [Environment Setup](#environment-setup)\n  - [🛳 Deployment](#-deployment)\n    - [`A` Hugging Face Spaces](#a-hugging-face-spaces)\n    - [`B` Local Deployment](#b-local-deployment)\n    - [`C` Environment Variables](#c-environment-variables)\n  - [📖 Usage Guide](#-usage-guide)\n    - [Basic Usage](#basic-usage)\n    - [Advanced Configuration](#advanced-configuration)\n  - [🎨 Story Customization](#-story-customization)\n  - [⌨️ Development](#️-development)\n  - [🤝 Contributing](#-contributing)\n  - [📄 License](#-license)\n  - [👥 Author](#-author)\n\n####\n\n\u003cbr/\u003e\n\n\u003c/details\u003e\n\n## 📸 Project Screenshots\n\n\u003e [!TIP]\n\u003e Experience the intuitive interface and powerful features of our AI storytelling platform.\n\nhttps://github.com/user-attachments/assets/4ab7053f-aeb4-4c70-800a-5c4b4e8285ba\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/2e03f96c-8ce8-4ab2-aed2-75dd31e61eb3\" alt=\"Main Dashboard\" width=\"800\"/\u003e\n  \u003cp\u003e\u003cem\u003eMain Interface - Story Creation and Character Settings\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/f1e329be-59dc-40cf-80e7-54c3eb9303e7\" alt=\"Advanced Settings\" width=\"800\"/\u003e\n  \u003cp\u003e\u003cem\u003eAdvanced Configuration - Fine-tune AI Parameters\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n## 🌟 Introduction\n\nWe are passionate about combining cutting-edge AI technology with creative storytelling. The Interactive Story Generator empowers users to create engaging narratives through intelligent AI collaboration, offering multiple genres, dynamic characters, and real-time story development.\n\nWhether you're a creative writer, educator, or storytelling enthusiast, this platform provides an innovative playground for narrative exploration. The project is actively developed and welcomes community feedback for any [issues][github-issues-link] encountered.\n\n\u003e [!NOTE]\n\u003e - Python 3.8+ required\n\u003e - Hugging Face API token required for AI model access\n\u003e - Gradio for intuitive web interface\n\u003e - Real-time story generation capabilities\n\n| [![][demo-shield-badge]][demo-site] | No installation required! Experience AI storytelling immediately. |\n| :------------------------------------ | :--------------------------------------------------------------------------------------------- |\n| [![][github-shield-badge]][github-stars-link] | Join our community! Star us to stay updated with new features and releases. |\n\n\u003e [!TIP]\n\u003e **⭐ Star us** to receive all release notifications and support the project's development!\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003ckbd\u003e⭐ Star History\u003c/kbd\u003e\u003c/summary\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=ChanMeng666%2Finteractive-story-generator\u0026theme=dark\u0026type=Date\"\u003e\n    \u003cimg width=\"100%\" src=\"https://api.star-history.com/svg?repos=ChanMeng666%2Finteractive-story-generator\u0026type=Date\"\u003e\n  \u003c/picture\u003e\n\u003c/details\u003e\n\n## ✨ Key Features\n\n### `1` AI-Powered Story Generation\n\nExperience next-generation storytelling with our advanced AI system powered by Hugging Face's Zephyr-7B-Beta model. The platform delivers coherent, engaging narratives that adapt to your creative input and maintain story continuity across multiple interactions.\n\nKey capabilities include:\n- 🤖 **Advanced AI Model**: Powered by HuggingFace Zephyr-7B-Beta\n- 🔄 **Real-time Generation**: Streaming story development\n- 🧠 **Context Awareness**: Maintains story coherence and character consistency\n- 🎯 **Adaptive Storytelling**: Responds intelligently to user input\n\n### `2` Multi-Genre Support\n\nChoose from diverse story genres and themes to match your creative vision. Our platform supports comprehensive customization options for different storytelling styles.\n\n**Available Genres:**\n- 🏰 **Fantasy**: Magical worlds and mythical creatures\n- 🚀 **Science Fiction**: Futuristic technology and space exploration\n- 🔍 **Mystery**: Puzzles, investigations, and suspenseful plots\n- 🗡️ **Adventure**: Thrilling journeys and heroic quests\n- 💕 **Romance**: Emotional connections and relationship dynamics\n- 👻 **Horror**: Supernatural elements and thrilling suspense\n\n**Story Themes:**\n- Adventure, Mystery, Romance, Historical, Slice of Life, Fairy Tale\n\n### `3` Dynamic Character Creation\n\nBuild compelling characters using expert-designed templates or create custom personalities from scratch. Our character system helps develop rich personalities that drive your story forward.\n\n**Character Templates:**\n- 🗡️ **Adventurer**: Brave explorers who love challenges\n- 🔍 **Detective**: Keen investigators with sharp observation skills\n- 🎨 **Artist**: Creative individuals with unique perspectives\n- 🔬 **Scientist**: Curious researchers dedicated to discovery\n- 👤 **Ordinary Person**: Relatable characters with rich inner worlds\n\n### `*` Additional Features\n\nBeyond core storytelling, the platform includes:\n\n- [x] 🎛️ **Advanced Controls**: Fine-tune creativity, coherence, and length\n- [x] 💾 **Story Management**: Save and export your creative works\n- [x] 🔄 **Real-time Interaction**: Continuous dialogue with AI\n- [x] 📊 **Parameter Control**: Adjust temperature, max tokens, and sampling\n- [x] 🎨 **Intuitive Interface**: User-friendly Gradio-based design\n- [x] 📱 **Responsive Design**: Works seamlessly across devices\n- [x] 🔧 **Customizable Settings**: Tailor the experience to your preferences\n- [x] 📖 **Built-in Guidance**: Comprehensive usage instructions\n\n\u003e ✨ More features are continuously being added based on community feedback.\n\n\u003cdiv align=\"right\"\u003e\n\n[![][back-to-top]](#readme-top)\n\n\u003c/div\u003e\n\n## 🛠️ Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/python\" width=\"48\" height=\"48\" alt=\"Python\" /\u003e\n        \u003cbr\u003ePython 3.8+\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/gradio\" width=\"48\" height=\"48\" alt=\"Gradio\" /\u003e\n        \u003cbr\u003eGradio 4.44\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/huggingface\" width=\"48\" height=\"48\" alt=\"Hugging Face\" /\u003e\n        \u003cbr\u003eHF Hub 0.25\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/pytorch\" width=\"48\" height=\"48\" alt=\"PyTorch\" /\u003e\n        \u003cbr\u003ePyTorch 2.2\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"96\"\u003e\n        \u003cimg src=\"https://cdn.simpleicons.org/transformers\" width=\"48\" height=\"48\" alt=\"Transformers\" /\u003e\n        \u003cbr\u003eTransformers\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n**Core Technologies:**\n- **Language**: Python 3.8+ for robust backend processing\n- **Interface**: Gradio 4.44.1 for intuitive web interface\n- **AI Engine**: Hugging Face Hub 0.25.2 for model access\n- **Deep Learning**: PyTorch 2.2.1 for neural network operations\n- **NLP**: Transformers 4.38.2 for advanced language processing\n\n**Key Libraries:**\n- **Environment Management**: python-dotenv for configuration\n- **Model Integration**: HuggingFace Zephyr-7B-Beta for story generation\n- **Real-time Streaming**: Gradio's streaming capabilities\n- **Error Handling**: Comprehensive logging and retry mechanisms\n\n\u003e [!TIP]\n\u003e Each technology was selected for production readiness, ease of use, and seamless integration with AI language models.\n\n## 🏗️ Architecture\n\n### System Architecture\n\n```mermaid\ngraph TB\n    subgraph \"User Interface\"\n        A[Gradio Web Interface] --\u003e B[Story Controls]\n        B --\u003e C[Character Settings]\n        C --\u003e D[Parameter Controls]\n    end\n    \n    subgraph \"Core Engine\"\n        E[Story Generator] --\u003e F[AI Model Client]\n        F --\u003e G[Context Manager]\n        G --\u003e H[Response Processor]\n    end\n    \n    subgraph \"AI Services\"\n        I[HuggingFace Hub]\n        J[Zephyr-7B-Beta Model]\n        K[Streaming API]\n    end\n    \n    subgraph \"Storage\"\n        L[Story Files]\n        M[User Sessions]\n        N[Configuration]\n    end\n    \n    A --\u003e E\n    F --\u003e I\n    I --\u003e J\n    J --\u003e K\n    E --\u003e L\n    A --\u003e M\n    D --\u003e N\n```\n\n### Data Flow\n\n```mermaid\nsequenceDiagram\n    participant U as User\n    participant G as Gradio Interface\n    participant S as Story Generator\n    participant H as HuggingFace API\n    participant M as AI Model\n    \n    U-\u003e\u003eG: Input Story Parameters\n    G-\u003e\u003eS: Process Story Request\n    S-\u003e\u003eH: Send Prompt to API\n    H-\u003e\u003eM: Forward to Zephyr Model\n    M-\u003e\u003eH: Stream Response\n    H-\u003e\u003eS: Return Generated Text\n    S-\u003e\u003eG: Update Story Display\n    G-\u003e\u003eU: Show Real-time Story\n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n\u003e [!IMPORTANT]\n\u003e Ensure you have the following installed:\n\n- Python 3.8 or higher ([Download](https://python.org/downloads/))\n- pip package manager\n- Git ([Download](https://git-scm.com/))\n- Hugging Face account and API token ([Get Token](https://huggingface.co/settings/tokens))\n\n### Quick Installation\n\n**1. Clone Repository**\n\n```bash\ngit clone https://github.com/ChanMeng666/interactive-story-generator.git\ncd interactive-story-generator\n```\n\n**2. Install Dependencies**\n\n```bash\n# Install required packages\npip install -r requirements.txt\n```\n\n**3. Environment Setup**\n\n```bash\n# Create environment file\ntouch .env\n\n# Add your Hugging Face token\necho \"HF_TOKEN=your_hugging_face_token_here\" \u003e\u003e .env\n```\n\n**4. Run Application**\n\n```bash\npython app.py\n```\n\n🎉 **Success!** Open [http://localhost:7860](http://localhost:7860) to start creating stories.\n\n### Environment Setup\n\nCreate a `.env` file with the following variables:\n\n```bash\n# Required: Hugging Face API Token\nHF_TOKEN=your_hugging_face_token_here\n\n# Optional: Custom model endpoint\nMODEL_ENDPOINT=HuggingFaceH4/zephyr-7b-beta\n\n# Optional: Application settings\nAPP_PORT=7860\nAPP_HOST=localhost\nDEBUG_MODE=false\n```\n\n\u003e [!TIP]\n\u003e Get your Hugging Face token from [https://huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)\n\n## 🛳 Deployment\n\n### `A` Hugging Face Spaces\n\n**One-Click Deployment:**\n\n[![Deploy to Hugging Face Spaces](https://huggingface.co/datasets/huggingface/badges/raw/main/deploy-to-spaces-sm.svg)](https://huggingface.co/spaces/ChanMeng666/interactive-story-generator)\n\n**Manual Deployment:**\n\n1. Create a new Space on Hugging Face\n2. Upload your code files\n3. Add your `HF_TOKEN` to Space secrets\n4. Configure Space settings for Gradio app\n\n### `B` Local Deployment\n\n**Development Mode:**\n\n```bash\n# Run with auto-reload\npython app.py\n\n# Run with specific port\npython app.py --port 7860\n```\n\n**Production Mode:**\n\n```bash\n# Install production dependencies\npip install gunicorn\n\n# Run with Gunicorn\ngunicorn app:demo.app --bind 0.0.0.0:7860\n```\n\n### `C` Environment Variables\n\n| Variable | Description | Required | Default | Example |\n|----------|-------------|----------|---------|---------|\n| `HF_TOKEN` | Hugging Face API token | ✅ | - | `hf_xxxxxxxxxxxxx` |\n| `MODEL_ENDPOINT` | AI model endpoint | 🔶 | `HuggingFaceH4/zephyr-7b-beta` | Custom model path |\n| `APP_PORT` | Application port | 🔶 | `7860` | `8080` |\n| `DEBUG_MODE` | Enable debug logging | 🔶 | `false` | `true` |\n\n\u003e [!NOTE]\n\u003e ✅ Required, 🔶 Optional\n\n## 📖 Usage Guide\n\n### Basic Usage\n\n**Getting Started:**\n\n1. **Choose Story Style** - Select from Fantasy, Sci-Fi, Mystery, Adventure, Romance, or Horror\n2. **Pick Theme** - Choose Adventure, Mystery, Romance, Historical, Slice of Life, or Fairy Tale\n3. **Create Character** - Use templates or custom descriptions\n4. **Describe Scene** - Set the initial story environment\n5. **Generate Story** - Click \"✨ Start Story\" to begin\n6. **Continue Narrative** - Interact with AI to develop the plot\n\n**Story Generation Process:**\n\n```python\n# Example story generation flow\nstory_params = {\n    \"style\": \"Fantasy\",\n    \"theme\": \"Adventure\", \n    \"character\": \"A brave knight seeking ancient treasures\",\n    \"scene\": \"A mysterious forest at dawn\"\n}\n\n# AI generates opening based on parameters\n# User provides input to continue story\n# AI maintains context and continues narrative\n```\n\n### Advanced Configuration\n\n**Parameter Controls:**\n\n- **Temperature (0.1-2.0)**: Controls creativity vs coherence\n  - Lower values (0.1-0.7): More focused, consistent output\n  - Higher values (0.8-2.0): More creative, varied output\n\n- **Max Tokens (64-1024)**: Controls response length\n  - Lower values: Concise responses\n  - Higher values: Detailed, elaborate responses\n\n- **Top-p (0.1-1.0)**: Controls vocabulary diversity\n  - Lower values: More predictable word choices\n  - Higher values: More varied vocabulary\n\n## 🎨 Story Customization\n\n**Character Templates:**\n\n```python\nCHARACTER_TEMPLATES = {\n    \"Adventurer\": \"A brave and fearless explorer who loves adventure and challenges.\",\n    \"Detective\": \"A keen and observant detective skilled in observation and deduction.\",\n    \"Artist\": \"A creative artist with unique perspectives on beauty.\",\n    \"Scientist\": \"A curious scientist dedicated to exploring the unknown.\",\n    \"Ordinary Person\": \"An ordinary person with a rich inner world.\"\n}\n```\n\n**Story Styles \u0026 Themes:**\n\n- **Fantasy**: Magical realms, mythical creatures, epic quests\n- **Science Fiction**: Future technology, space exploration, AI\n- **Mystery**: Puzzles, investigations, hidden secrets\n- **Adventure**: Thrilling journeys, heroic challenges\n- **Romance**: Emotional connections, relationship dynamics\n- **Horror**: Supernatural elements, suspenseful atmosphere\n\n## ⌨️ Development\n\n**Setup Development Environment:**\n\n```bash\n# Clone repository\ngit clone https://github.com/ChanMeng666/interactive-story-generator.git\ncd interactive-story-generator\n\n# Install development dependencies\npip install -r requirements.txt\n\n# Run in development mode\npython app.py\n```\n\n**Development Scripts:**\n\n```bash\n# Start development server\npython app.py\n\n# Run with debug mode\nDEBUG_MODE=true python app.py\n\n# Test story generation\npython -c \"from app import generate_story; print(list(generate_story('test scene', 'Fantasy', 'Adventure', 'test character')))\"\n```\n\n**Project Structure:**\n\n```\ninteractive-story-generator/\n├── app.py                    # Main application file\n├── requirements.txt          # Python dependencies\n├── .env                     # Environment variables\n├── stories/                 # Generated story files\n├── public/                  # Static assets\n│   └── interactive-story-generator-logo.svg\n├── README.md               # Project documentation\n├── LICENSE                 # Apache 2.0 License\n└── CODE_OF_CONDUCT.md     # Community guidelines\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help improve the Interactive Story Generator:\n\n**Ways to Contribute:**\n- 🐛 **Bug Reports**: Help identify and fix issues\n- 💡 **Feature Requests**: Suggest new capabilities\n- 📚 **Documentation**: Improve guides and examples\n- 🔧 **Code Contributions**: Submit pull requests\n- 🎨 **UI/UX Improvements**: Enhance user experience\n\n**Development Process:**\n\n1. **Fork the Repository**\n2. **Create Feature Branch**: `git checkout -b feature/amazing-feature`\n3. **Make Changes**: Follow coding standards\n4. **Add Tests**: Ensure functionality works\n5. **Submit PR**: Include clear description\n\n**Contribution Guidelines:**\n- Follow Python PEP 8 style guidelines\n- Add docstrings for new functions\n- Include tests for new features\n- Update documentation as needed\n\n[![][pr-welcome-shield]][github-issues-link]\n\n## 📄 License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n**License Benefits:**\n- ✅ Commercial use allowed\n- ✅ Modification allowed\n- ✅ Distribution allowed\n- ✅ Private use allowed\n\n## 👥 Author\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/ChanMeng666\"\u003e\n          \u003cimg src=\"https://github.com/ChanMeng666.png?size=100\" width=\"100px;\" alt=\"Chan Meng\"/\u003e\n          \u003cbr /\u003e\n          \u003csub\u003e\u003cb\u003eChan Meng\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n        \u003cbr /\u003e\n        \u003csmall\u003eCreator \u0026 Lead Developer\u003c/small\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n**Contact Information:**\n- \u003cimg src=\"https://cdn.simpleicons.org/github/181717\" width=\"16\" height=\"16\"\u003e GitHub: [ChanMeng666](https://github.com/ChanMeng666)\n- \u003cimg src=\"https://cdn.simpleicons.org/linkedin/0A66C2\" width=\"16\" height=\"16\"\u003e LinkedIn: [chanmeng666](https://www.linkedin.com/in/chanmeng666/)\n- \u003cimg src=\"https://cdn.simpleicons.org/gmail/EA4335\" width=\"16\" height=\"16\"\u003e Email: [chanmeng.dev@gmail.com](mailto:chanmeng.dev@gmail.com)\n- \u003cimg src=\"https://cdn.simpleicons.org/internetexplorer/0078D4\" width=\"16\" height=\"16\"\u003e Portfolio: [chanmeng.live](https://2d-portfolio-eta.vercel.app/)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003cstrong\u003e🎭 Pioneering AI-Powered Storytelling 🌟\u003c/strong\u003e\n\u003cbr/\u003e\n\u003cem\u003eEmpowering creativity through intelligent collaboration\u003c/em\u003e\n\u003cbr/\u003e\u003cbr/\u003e\n\n⭐ **Star us on GitHub** • 📖 **Read the Documentation** • 🐛 **Report Issues** • 💡 **Request Features** • 🤝 **Contribute**\n\n\u003cbr/\u003e\u003cbr/\u003e\n\n**Made with ❤️ by [Chan Meng](https://github.com/ChanMeng666)**\n\n\u003cimg src=\"https://img.shields.io/github/stars/ChanMeng666/interactive-story-generator?style=social\" alt=\"GitHub stars\"\u003e\n\u003cimg src=\"https://img.shields.io/github/forks/ChanMeng666/interactive-story-generator?style=social\" alt=\"GitHub forks\"\u003e\n\n\u003c/div\u003e\n\n---\n\n\u003c!-- LINK DEFINITIONS --\u003e\n\n[back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square\n\n\u003c!-- Project Links --\u003e\n[demo-site]: https://huggingface.co/spaces/ChanMeng666/interactive-story-generator\n[docs]: https://github.com/ChanMeng666/interactive-story-generator/blob/main/README.md\n[contributing-guide]: https://github.com/ChanMeng666/interactive-story-generator/blob/main/CODE_OF_CONDUCT.md\n\n\u003c!-- GitHub Links --\u003e\n[github-issues-link]: https://github.com/ChanMeng666/interactive-story-generator/issues\n[github-stars-link]: https://github.com/ChanMeng666/interactive-story-generator/stargazers\n[github-forks-link]: https://github.com/ChanMeng666/interactive-story-generator/forks\n[github-release-link]: https://github.com/ChanMeng666/interactive-story-generator/releases\n[github-license-link]: https://github.com/ChanMeng666/interactive-story-generator/blob/main/LICENSE\n\n\u003c!-- Tech Stack Links --\u003e\n[python-link]: https://python.org\n[gradio-link]: https://gradio.app\n[huggingface-link]: https://huggingface.co\n[pytorch-link]: https://pytorch.org\n\n\u003c!-- Shield Badges --\u003e\n[github-release-shield]: https://img.shields.io/github/v/release/ChanMeng666/interactive-story-generator?color=369eff\u0026labelColor=black\u0026logo=github\u0026style=flat-square\n[github-stars-shield]: https://img.shields.io/github/stars/ChanMeng666/interactive-story-generator?color=ffcb47\u0026labelColor=black\u0026style=flat-square\n[github-forks-shield]: https://img.shields.io/github/forks/ChanMeng666/interactive-story-generator?color=8ae8ff\u0026labelColor=black\u0026style=flat-square\n[github-issues-shield]: https://img.shields.io/github/issues/ChanMeng666/interactive-story-generator?color=ff80eb\u0026labelColor=black\u0026style=flat-square\n[github-license-shield]: https://img.shields.io/badge/license-Apache%202.0-white?labelColor=black\u0026style=flat-square\n\n[python-shield]: https://img.shields.io/badge/python-%3E%3D3.8-blue?style=flat-square\u0026logo=python\u0026logoColor=white\n[gradio-shield]: https://img.shields.io/badge/gradio-4.44.1-orange?style=flat-square\u0026logo=gradio\u0026logoColor=white\n[huggingface-shield]: https://img.shields.io/badge/huggingface-0.25.2-yellow?style=flat-square\u0026logo=huggingface\u0026logoColor=white\n[pytorch-shield]: https://img.shields.io/badge/pytorch-2.2.1-red?style=flat-square\u0026logo=pytorch\u0026logoColor=white\n\n[pr-welcome-shield]: https://img.shields.io/badge/🤝_PRs_welcome-%E2%86%92-ffcb47?labelColor=black\u0026style=for-the-badge\n\n\u003c!-- Badge Variants --\u003e\n[demo-shield-badge]: https://img.shields.io/badge/TRY%20DEMO-ONLINE-55b467?labelColor=black\u0026logo=vercel\u0026style=for-the-badge\n[github-shield-badge]: https://img.shields.io/badge/STAR%20ON-GITHUB-181717?labelColor=black\u0026logo=github\u0026style=for-the-badge\n\n\u003c!-- Social Share Links --\u003e\n[share-x-link]: https://x.com/intent/tweet?hashtags=AI,storytelling,opensource\u0026text=Check%20out%20this%20amazing%20AI%20story%20generator\u0026url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Finteractive-story-generator\n[share-linkedin-link]: https://linkedin.com/sharing/share-offsite/?url=https://github.com/ChanMeng666/interactive-story-generator\n[share-reddit-link]: https://www.reddit.com/submit?title=Interactive%20Story%20Generator%20-%20AI%20Powered%20Storytelling\u0026url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Finteractive-story-generator\n[share-telegram-link]: https://t.me/share/url?text=Check%20out%20this%20AI%20story%20generator\u0026url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Finteractive-story-generator\n\n[share-x-shield]: https://img.shields.io/badge/-share%20on%20x-black?labelColor=black\u0026logo=x\u0026logoColor=white\u0026style=flat-square\n[share-linkedin-shield]: https://img.shields.io/badge/-share%20on%20linkedin-black?labelColor=black\u0026logo=linkedin\u0026logoColor=white\u0026style=flat-square\n[share-reddit-shield]: https://img.shields.io/badge/-share%20on%20reddit-black?labelColor=black\u0026logo=reddit\u0026logoColor=white\u0026style=flat-square\n[share-telegram-shield]: https://img.shields.io/badge/-share%20on%20telegram-black?labelColor=black\u0026logo=telegram\u0026logoColor=white\u0026style=flat-square\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchanmeng666%2Finteractive-story-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchanmeng666%2Finteractive-story-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchanmeng666%2Finteractive-story-generator/lists"}