Apppublic

ChanMeng666/emoji-story-generator

sourceHugging Facemitupdated 6mo agoView on Hugging Face

0likes

App README

![Project Banner](#)

🚀 Emoji Story Generator<br/><h3>AI-Powered Creative Storytelling Platform</h3>

An innovative storytelling application that leverages cutting-edge AI technology to transform emoji selections into engaging narratives.<br/> Supports 8 emoji categories with 200+ emojis, HuggingFace Inference Providers API with Llama-3.1-8B-Instruct model, and a community-driven story library.<br/> One-click FREE deployment of your creative story generator.

🌟 Live Demo · 📖 Documentation · 🐛 Issues · 💡 Features

<br/>

![🎭 Create Stories Now 🎨](https://huggingface.co/spaces/ChanMeng666/emoji-story-generator)

<br/>

[![][github-release-shield]][github-release-link] [![][python-shield]][python-link] [![][streamlit-shield]][streamlit-link] [![][huggingface-shield]][huggingface-link]<br/> [![][github-contributors-shield]][github-contributors-link] [![][github-forks-shield]][github-forks-link] [![][github-stars-shield]][github-stars-link] [![][github-issues-shield]][github-issues-link] [![][github-license-shield]][github-license-link]

Share Emoji Story Generator

[![][share-x-shield]][share-x-link] [![][share-reddit-shield]][share-reddit-link] [![][share-linkedin-shield]][share-linkedin-link]

<sup>🌟 Revolutionizing creative storytelling through AI and emojis. Built for writers, educators, and creative minds.</sup>

</div>

📸 Project Screenshots

[!TIP] Experience the intuitive interface and powerful AI story generation capabilities.

<div align="center"> <img src="https://github.com/user-attachments/assets/ecaf4494-7e51-4b86-9e79-7548957d0bcd" alt="Main Interface" width="800"/> <p><em>Main Interface - Emoji Selection and Story Generation</em></p> </div>

<div align="center"> <img src="https://github.com/user-attachments/assets/4b48b701-7528-40c2-91af-9f9997abb822" alt="Story Generation Process" width="800"/> <p><em>AI Story Generation in Action</em></p> </div>

<details> <summary><kbd>📱 More Screenshots</kbd></summary>

<div align="center"> <p><em>Coming soon - Mobile responsive design and additional UI features</em></p> </div>

</details>

🎬 Demo Video

[!NOTE] Watch how the AI transforms simple emoji selections into compelling stories.

https://github.com/user-attachments/assets/ecaf4494-7e51-4b86-9e79-7548957d0bcd

Experience the magic of AI-powered storytelling

</div>

Tech Stack Badges:

</div>

[!IMPORTANT] This project demonstrates modern AI integration with user-friendly interfaces. It combines Python's Streamlit framework with HuggingFace's Inference Providers API (using meta-llama/Llama-3.1-8B-Instruct) to provide creative storytelling capabilities. Features include emoji categorization, real-time story generation, three reaction types (like/love/star) with session-based deduplication, search & sort & pagination, professional custom-CSS UI with gradient theme, and persistent data storage via SQLite + JSON backup.

<details> <summary><kbd>📑 Table of Contents</kbd></summary>

—🚀 Emoji Story GeneratorAI-Powered Creative Storytelling Platform
—📸 Project Screenshots
—🎬 Demo Video
—TOC
—[](#)
—🌟 Introduction
—✨ Key Features
—`1` AI-Powered Story Generation
—`2` Intelligent Emoji Categorization
—`*` Additional Features
—🛠️ Tech Stack
—🏗️ Architecture
—System Architecture
—Component Structure
—Data Flow
—⚡️ Performance
—Performance Metrics
—🚀 Getting Started
—Prerequisites
—Quick Installation
—HuggingFace API Setup
—🛳 Deployment
—Cloud Deployment Options
—Local Development Setup
—Environment Variables
—📖 Usage Guide
—Basic Usage
—Advanced Features
—API Integration
—🔌 Integrations
—⌨️ Development
—Local Development Setup
—Code Structure
—Adding New Features
—🤝 Contributing
—How to Contribute
—Contribution Ideas
—Code Style Guidelines
—📄 License
—👥 Team
—Project Maintainer

####

<br/>

</details>

🌟 Introduction

We are passionate developers creating the next generation of creative AI applications. By combining the universal language of emojis with advanced language models, we've built a platform that democratizes storytelling and unleashes creativity for users of all ages.

Whether you're an educator looking for engaging classroom activities, a parent seeking creative bedtime stories, or a writer battling creative blocks, Emoji Story Generator transforms simple emoji selections into rich, coherent narratives. The application is designed with accessibility and ease of use in mind, making AI-powered creativity accessible to everyone.

[!NOTE] - Python 3.7+ required - HuggingFace API token required for AI story generation - Internet connection required for model inference - Modern web browser recommended for optimal experience

[![][demo-shield-badge]][demo-link]	No installation required! Visit our live demo to start creating stories instantly.
[![][community-shield-badge]][community-link]	Join our growing community of storytellers and creative minds!

[!TIP] ⭐ Star us to receive all release notifications and support the project's continued development!

✨ Key Features

`1` AI-Powered Story Generation

Experience cutting-edge storytelling with Meta's Llama-3.1-8B-Instruct model via HuggingFace Inference Providers. Our sophisticated prompt engineering ensures that every generated story follows a clear narrative structure with compelling characters, engaging plots, and satisfying conclusions.

Advanced AI Capabilities:

—🧠 Intelligent Narrative Structure: Automatic beginning-middle-end story construction
—🎭 Character Development: Dynamic character creation based on emoji context
—📖 Coherent Storytelling: Advanced language model ensures logical flow and readability
—🎯 Context Awareness: Smart emoji interpretation for meaningful story integration

Story Quality Features:

—✅ Family-Friendly Content: All stories are suitable for all ages
—✅ Complete Narratives: No cliffhangers or incomplete endings
—✅ Optimized Length: 100-150 words perfect for quick reading
—✅ Professional Editing: Automatic cleanup of AI-generated content

`2` Intelligent Emoji Categorization

Navigate through our carefully curated collection of 200+ emojis organized into 8 intuitive categories. Each category is designed to inspire different types of stories and creative directions.

Category System:

—😀 Faces & Emotions (36 emojis): Express feelings and character personalities
—🐶 Animals (24 emojis): Bring wildlife and pets into your stories
—🌸 Plants (22 emojis): Add natural elements and scenic beauty
—🍎 Food (48 emojis): Include culinary adventures and dining experiences
—⚽ Activities & Sports (24 emojis): Create action-packed scenarios
—🚗 Transportation (24 emojis): Enable journey and adventure narratives
—🏠 Places & Buildings (24 emojis): Set scenes in diverse locations
—📱 Objects & Symbols (36 emojis): Add props and symbolic elements

Smart Selection Features:

—🎯 Maximum 5 Emojis: Optimal balance for coherent storytelling
—🔄 Easy Management: One-click clear and selection management
—📱 Responsive Design: Seamless experience across all devices
—🎨 Visual Feedback: Intuitive interface with real-time selection display

`*` Additional Features

Beyond core story generation, the platform includes community, management, and professional UI features:

—[x] 💾 Persistent Storage: SQLite for fast queries + JSON backup in /data for HF Spaces persistence across restarts
—[x] 👍❤️⭐ Three Reaction Types: Like, Love, and Star reactions with toggle support
—[x] 🛡️ Vote Deduplication: Session-based UUID + database UNIQUE constraint prevents duplicate votes
—[x] 🔍 Search & Filter: Search stories by content or emojis
—[x] 📊 Sort Options: Most Popular, Newest First, Oldest First
—[x] 📄 Pagination: 8 stories per page with Previous/Next navigation
—[x] 📋 Copy to Clipboard: One-click story copying for sharing
—[x] 🗑️ Session-Scoped Deletion: Creators can delete their own stories
—[x] ↩️ Undo Selection: Remove last selected emoji or clear all
—[x] 🕐 Relative Timestamps: Human-readable time display ("2h ago")
—[x] 🎨 Custom CSS Theme: Gradient colors, card layouts, hover animations, styled buttons
—[x] 🖼️ Embedded Logo: Base64-encoded SVG logo in custom header
—[x] 🌗 Dark/Light Theme: CSS media query support for both themes
—[x] 📱 Mobile Responsive: Optimized for all screen sizes
—[x] 🌐 Web-Based: No installation required, accessible anywhere

✨ More features are continuously being added based on community feedback and usage patterns.

[![][back-to-top]](#readme-top)

</div>

🛠️ Tech Stack

<div align="center"> <table> <tr> <td align="center" width="96"> <img src="https://cdn.simpleicons.org/python" width="48" height="48" alt="Python" /> <br>Python 3.7+ </td> <td align="center" width="96"> <img src="https://cdn.simpleicons.org/streamlit" width="48" height="48" alt="Streamlit" /> <br>Streamlit </td> <td align="center" width="96"> <img src="https://cdn.simpleicons.org/huggingface" width="48" height="48" alt="HuggingFace" /> <br>HuggingFace API </td> <td align="center" width="96"> <img src="https://cdn.simpleicons.org/sqlite" width="48" height="48" alt="SQLite" /> <br>SQLite + JSON Backup </td> <td align="center" width="96"> <img src="https://cdn.simpleicons.org/dotenv" width="48" height="48" alt="Python dotenv" /> <br>Environment Config </td> </tr> </table> </div>

Core Technologies:

—Framework: Streamlit for rapid web app development
—Language: Python 3.7+
—AI Model: meta-llama/Llama-3.1-8B-Instruct via HuggingFace Inference Providers
—API Client: huggingface_hub InferenceClient for provider-routed inference
—Configuration: Python-dotenv for environment management

Data & Storage:

—Local Storage: SQLite database for queries, JSON backup in /data for persistence across restarts
—Session Management: Streamlit session state for user interactions
—Configuration: Environment variables for secure API key management

Deployment Options:

—Cloud Platforms: HuggingFace Spaces, Streamlit Cloud
—Local Development: Python virtual environment
—Containerization: Docker support for consistent deployments

[!TIP] Each technology was selected for its reliability, community support, and ease of deployment across various platforms.

🏗️ Architecture

System Architecture

[!TIP] This architecture supports scalable deployment and easy maintenance, making it suitable for both personal use and educational environments.

mermaid

graph TB
    subgraph "Frontend Layer"
        A[Streamlit UI] --> B[Emoji Categories]
        B --> C[Story Display]
        C --> D[Voting System]
    end
    
    subgraph "Application Layer"
        E[Story Generator] --> F[AI Integration]
        F --> G[Data Management]
        G --> H[Session State]
    end
    
    subgraph "External Services"
        I[HuggingFace Inference Providers]
        J[Llama-3.1-8B-Instruct]
    end
    
    subgraph "Data Layer"
        K[SQLite + JSON Backup]
        L[Environment Config]
    end
    
    A --> E
    F --> I
    I --> J
    G --> K
    E --> L

Component Structure

emoji-story-generator/
├── app.py                     # Main application (~950 lines)
│                              #   ├── CUSTOM_CSS          - Full CSS theme
│                              #   ├── EMOJI_CATEGORIES    - 8 categories, 238+ emojis
│                              #   ├── Database Layer       - SQLite + JSON backup/restore
│                              #   ├── AI Generation        - HF Inference Providers API
│                              #   ├── UI Helpers           - Header, emoji tray, story cards
│                              #   └── main()               - Streamlit app entry point
├── requirements.txt           # Python dependencies (streamlit, python-dotenv, huggingface_hub)
├── .env                       # Environment configuration (HUGGINGFACE_API_TOKEN)
├── public/
│   ├── emoji-story-generator-logo.svg   # Project logo (embedded as base64 in header)
│   └── emoji-story-generator.svg        # Additional SVG asset
├── CLAUDE.md                  # AI assistant guidance for codebase
├── README.md                  # Project documentation
├── CODE_OF_CONDUCT.md         # Community guidelines
└── LICENSE                    # MIT license

Runtime files (not committed):

stories.db                     # Local SQLite database (gitignored)
/data/stories_backup.json      # Persistent JSON backup on HF Spaces Storage Bucket

Data Flow

mermaid

sequenceDiagram
    participant U as User
    participant S as Streamlit UI
    participant A as App Logic
    participant H as HuggingFace API
    participant DB as SQLite
    participant B as /data Backup

    Note over DB,B: On startup: restore from backup if DB is empty
    B-->>DB: _restore_from_backup()

    U->>S: Select Emojis (up to 5)
    U->>S: Click "Generate Story"
    S->>A: Trigger Generation
    A->>H: Send Prompt + Emojis
    H->>A: Return Generated Story
    A->>A: Clean response (strip markers, fix endings)
    A->>DB: INSERT story (SQLite)
    A->>B: _backup_to_json()
    A->>S: Display Story Card
    S->>U: Show Result with Reactions

    U->>S: Click Reaction (👍/❤️/⭐)
    S->>A: toggle_vote(story_id, session_id, type)
    A->>DB: INSERT or DELETE vote (UNIQUE constraint)
    A->>B: _backup_to_json()
    S->>U: Update Reaction Count

⚡️ Performance

Performance Metrics

Response Times:

—⚡ Emoji Selection: < 100ms instant response
—🤖 AI Story Generation: 15-30 seconds (depends on HuggingFace API)
—💾 Story Saving: < 50ms SQLite write + async JSON backup
—🗳️ Voting Updates: < 50ms SQLite toggle + backup

Scalability Features:

—📊 Efficient State Management: Streamlit session state optimization
—🔄 Smart Caching: @st.cache_resource for database connection
—📱 Responsive Design: Custom CSS with mobile breakpoints
—🚀 Fast Loading: Minimal dependencies for quick startup
—📄 Paginated Queries: SQLite LIMIT/OFFSET prevents loading all stories at once

Reliability Metrics:

—🛡️ Error Handling: Comprehensive API error management
—💾 Data Integrity: SQLite ACID transactions + JSON backup to persistent storage
—🔒 Vote Deduplication: UNIQUE constraint prevents duplicate votes per session
—⚠️ User Feedback: Clear error messages and loading indicators
—🔄 Auto-Restore: Data automatically restored from backup on container restart

[!NOTE] Performance metrics may vary based on HuggingFace API availability and network conditions.

🚀 Getting Started

Prerequisites

[!IMPORTANT] Ensure you have the following before starting:

—Python 3.7 or higher (Download)
—HuggingFace account and API token (Sign up)
—Git for version control (Download)
—Modern web browser (Chrome, Firefox, Safari, Edge)

Quick Installation

1. Clone Repository

bash

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

2. Set Up Virtual Environment

bash

# Create virtual environment
python -m venv emoji-story-env

# Activate virtual environment
# On Windows:
emoji-story-env\Scripts\activate
# On macOS/Linux:
source emoji-story-env/bin/activate

3. Install Dependencies

bash

pip install -r requirements.txt

4. Environment Configuration

bash

# Create environment file
echo "HUGGINGFACE_API_TOKEN=your_token_here" > .env

# Replace 'your_token_here' with your actual HuggingFace API token

5. Launch Application

bash

streamlit run app.py

🎉 Success! Open http://localhost:8501 to start creating stories!

HuggingFace API Setup

1.Create Account: Visit HuggingFace and create a free account
2.Generate Token: Go to Settings → Access Tokens → Create new token (Fine-grained)
3.Enable Permission: Check "Make calls to Inference Providers" under Inference section
4.Copy Token: Copy the generated token
5.Set Environment: Add token to .env file as shown above

[!TIP] Your HuggingFace token must have "Make calls to Inference Providers" permission enabled. Keep it secure and never commit it to version control.

🛳 Deployment

Cloud Deployment Options

HuggingFace Spaces (Recommended)

![Deploy to HuggingFace](https://huggingface.co/new-space?template=ChanMeng666/emoji-story-generator)

1.Fork this repository
2.Create a new HuggingFace Space (SDK: Streamlit)
3.Connect your GitHub repository
4.Add your HUGGINGFACE_API_TOKEN as a Secret in Space settings
5.Mount a Storage Bucket at /data (Read & Write) for persistent data backup
6.Deploy automatically

Manual Cloud Deployment:

Streamlit Cloud	Railway	Render
[![][deploy-streamlit-button]][deploy-streamlit-link]	[![][deploy-railway-button]][deploy-railway-link]	[![][deploy-render-button]][deploy-render-link]

</div>

Local Development Setup

bash

# Clone and setup
git clone https://github.com/ChanMeng666/emoji-story-generator.git
cd emoji-story-generator

# Install in development mode
pip install -r requirements.txt

# Set up environment
cp .env.example .env
# Edit .env with your API token

# Run with auto-reload
streamlit run app.py --server.runOnSave true

Environment Variables

Variable	Description	Required	Example
`HUGGINGFACE_API_TOKEN`	HuggingFace API access token	✅	`hf_xxxxxxxxxxxxx`

[!WARNING] Never commit your API tokens to version control. Use environment variables or secure secret management in production.

📖 Usage Guide

Basic Usage

Creating Your First Story:

1.Launch Application - Open the app in your web browser
2.Select Emojis - Browse through 8 categories and click up to 5 emojis
3.Generate Story - Click "Generate Story" and wait for AI processing
4.Read & Share - Enjoy your unique story and share with others
5.Vote & Explore - Like stories from other users and explore the library

Advanced Features

Story Library Management:

—📚 Browse Stories: View all generated stories with card-based layout and rank badges
—🔍 Search: Filter stories by content or emojis via the search bar
—📊 Sort Options: Switch between Most Popular, Newest First, or Oldest First
—📄 Pagination: Navigate through stories 8 per page

Reactions & Interactions:

—👍❤️⭐ Three Reaction Types: Like, Love, or Star any story (toggleable)
—📋 Copy to Clipboard: Click "Copy" to get the full story text
—🗑️ Delete Own Stories: Creators can remove their own stories (session-scoped)
—🕐 Timestamps: See when each story was created in relative time

Emoji Selection Tips:

—🎯 Diverse Categories: Mix emojis from different categories for richer stories
—🎭 Character Focus: Include emotion emojis to define character personalities
—🌍 Setting Elements: Add location and object emojis for detailed scenes
—⚖️ Balanced Selection: Use 3-5 emojis for optimal story coherence
—↩️ Undo: Click "Undo" to remove the last emoji, or "Clear All" to start over

API Integration

For developers wanting to integrate the story generation functionality:

python

import os
from huggingface_hub import InferenceClient

def generate_story(emojis, api_token):
    """Generate story using HuggingFace Inference Providers API"""

    emoji_text = ' '.join(emojis)
    prompt = f"""Create a short story (100-150 words) using these emojis: {emoji_text}

    Instructions:
    1. Write a coherent story with clear beginning, middle, and end
    2. Make it family-friendly
    3. Incorporate all provided emojis naturally
    """

    client = InferenceClient(token=api_token)
    response = client.chat_completion(
        model="meta-llama/Llama-3.1-8B-Instruct",
        messages=[{"role": "user", "content": prompt}],
        max_tokens=250,
        temperature=0.7,
        top_p=0.9,
    )

    return response.choices[0].message.content

# Example usage
story = generate_story(["😊", "🐶", "🏠"], os.getenv("HUGGINGFACE_API_TOKEN"))

🔌 Integrations

Current integrations and future roadmap:

Integration	Status	Description	Documentation
HuggingFace Inference Providers	✅ Active	Llama-3.1-8B-Instruct for story generation	HF Docs
Streamlit Cloud	✅ Active	Free cloud deployment platform	Deploy Guide
SQLite + JSON Backup	✅ Active	Local SQLite for queries, JSON backup for persistence	Built-in
Environment Config	✅ Active	Secure API key management	Setup Guide
Google Analytics	🔶 Planned	Usage analytics and insights	Coming Soon
User Authentication	🔶 Planned	Personal story libraries	Coming Soon
Export Features	🔶 Planned	PDF/Text story exports	Coming Soon

📊 Total planned integrations: <kbd>**10+**</kbd>

⌨️ Development

Local Development Setup

Development Environment:

bash

# Clone repository
git clone https://github.com/ChanMeng666/emoji-story-generator.git
cd emoji-story-generator

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment
echo "HUGGINGFACE_API_TOKEN=your_token" > .env

# Run development server
streamlit run app.py --server.runOnSave true

Development Scripts:

bash

# Development
streamlit run app.py                    # Start development server
streamlit run app.py --server.port 8502  # Custom port

# Code Quality
python -m py_compile app.py             # Syntax check
python -m doctest app.py                # Test docstrings

# Deployment
pip freeze > requirements.txt           # Update dependencies
git add . && git commit -m "Update"     # Version control

Code Structure

Main Application (`app.py` ~950 lines):

Section	Description
CUSTOM_CSS	Full CSS theme with gradients, card layouts, hover effects, dark/light support
EMOJI_CATEGORIES	8 categories with 238+ emojis (Chinese internal names + English display)
Database Layer	SQLite connection (`@st.cache_resource`), CRUD operations, JSON backup/restore
AI Generation	HuggingFace Inference Providers API, prompt construction, response cleanup
UI Helpers	`render_header()`, `render_emoji_tray()`, `render_story_card()`, `relative_time()`
main()	Streamlit app: emoji picker → tray → generate → stories list with reactions

Key Functions:

—get_db(): Cached SQLite connection, creates tables, restores from backup on startup
—add_story() / delete_story(): Story CRUD with automatic JSON backup
—toggle_vote(): Toggle like/love/star reactions with deduplication
—get_stories(): Paginated query with sort and search support
—_backup_to_json() / _restore_from_backup(): Persistent JSON backup in /data
—generate_story_with_ai(): Prompt construction → API call → response cleanup
—query_huggingface(): InferenceClient.chat_completion() wrapper
—render_story_card(): Card UI with metadata, reactions, copy, and delete

Adding New Features

1. New Emoji Categories:

python

# Add to EMOJI_CATEGORIES dictionary in app.py
EMOJI_CATEGORIES["新类别"] = ["🆕", "📝", "✨", "🎉"]

# Add English display name in ENGLISH_CATEGORIES
ENGLISH_CATEGORIES["🎉 New Category"] = "新类别"

2. Custom CSS Styling:

python

# Add styles to the CUSTOM_CSS string constant at the top of app.py
CUSTOM_CSS = """
<style>
/* ... existing styles ... */

/* Your custom styles */
.my-component {
    background: linear-gradient(135deg, #667eea, #764ba2);
    border-radius: 16px;
}
</style>
"""

3. Additional AI Parameters:

python

# Modify generation parameters in query_huggingface()
response = client.chat_completion(
    model=MODEL_ID,
    messages=[{"role": "user", "content": prompt_text}],
    max_tokens=300,        # Longer stories
    temperature=0.8,       # More creativity
    top_p=0.95,           # Better coherence
)

🤝 Contributing

We welcome contributions from developers, storytellers, and creative minds! Here's how you can help improve the project:

How to Contribute

1. Fork & Clone:

bash

git clone https://github.com/YOUR_USERNAME/emoji-story-generator.git
cd emoji-story-generator

2. Create Feature Branch:

bash

git checkout -b feature/amazing-new-feature

3. Make Changes:

—Follow Python PEP 8 style guidelines
—Add comments for complex logic
—Test your changes locally
—Update documentation if needed

4. Submit Pull Request:

—Provide clear description of changes
—Include screenshots for UI changes
—Reference related issues
—Ensure code passes basic syntax checks

Contribution Ideas

🤖 AI Enhancements:

—Alternative AI model integrations (GPT, Claude, etc.)
—Custom prompt templates for different genres
—Story length options (short/medium/long)
—Multi-language story generation

📊 Features:

—User authentication system (persistent identity across sessions)
—Story export functionality (PDF/text)
—Advanced emoji-based filtering (filter stories by emoji category)
—Analytics dashboard for story statistics
—Social sharing with Open Graph preview

🛠️ Technical:

—API rate limiting per session
—WebSocket for real-time vote updates
—Automated testing suite
—CI/CD pipeline

Code Style Guidelines

—Use descriptive variable names
—Add docstrings for functions
—Keep functions focused and small
—Handle errors gracefully
—Include type hints where appropriate

python

def generate_story_with_ai(emojis: list[str]) -> str | None:
    """
    Generate a story using AI based on selected emojis.
    
    Args:
        emojis: List of emoji strings to incorporate into story
        
    Returns:
        Generated story string or None if generation fails
    """
    # Implementation here

📄 License

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

Open Source Benefits:

—✅ Commercial use allowed
—✅ Modification allowed
—✅ Distribution allowed
—✅ Private use allowed

Attribution: While not required, attribution is appreciated when using this project as a base for your own applications.

👥 Team

<div align="center"> <table> <tr> <td align="center"> <a href="https://github.com/ChanMeng666"> <img src="https://github.com/ChanMeng666.png?size=100" width="100px;" alt="Chan Meng"/> <br /> <sub><b>Chan Meng</b></sub> </a> <br /> <small>Creator & Lead Developer</small> <br /> <small>🎨 UI/UX • 🤖 AI Integration • 📱 Full-Stack</small> </td> </tr> </table> </div>

Project Maintainer

Chan Meng - Full-Stack Developer & AI Enthusiast

—<img src="https://cdn.simpleicons.org/linkedin/0A66C2" width="16" height="16"> LinkedIn: chanmeng666
—<img src="https://cdn.simpleicons.org/github/181717" width="16" height="16"> GitHub: ChanMeng666
—<img src="https://cdn.simpleicons.org/gmail/EA4335" width="16" height="16"> Email: chanmeng.dev@gmail.com
—<img src="https://cdn.simpleicons.org/internetexplorer/0078D4" width="16" height="16"> Website: chanmeng.live

Specializations:

—🤖 AI/ML Integration and Prompt Engineering
—🎨 Creative Application Development
—📱 Cross-Platform Web Applications
—🚀 Rapid Prototyping and MVP Development

<div align="center"> <strong>🎭 Transforming Emojis into Stories 📚</strong> <br/> <em>Empowering creativity through AI and imagination</em> <br/><br/>

⭐ Star us on GitHub • 🎨 Try the Demo • 🐛 Report Issues • 💡 Suggest Features • 🤝 Contribute Code

Made with ❤️ by creative minds for creative minds

</div>

[back-to-top]: https://img.shields.io/badge/-BACKTOTOP-151515?style=flat-square

[demo-link]: https://huggingface.co/spaces/ChanMeng666/emoji-story-generator [community-link]: https://github.com/ChanMeng666/emoji-story-generator/discussions

[github-issues-link]: https://github.com/ChanMeng666/emoji-story-generator/issues [github-stars-link]: https://github.com/ChanMeng666/emoji-story-generator/stargazers [github-forks-link]: https://github.com/ChanMeng666/emoji-story-generator/forks [github-contributors-link]: https://github.com/ChanMeng666/emoji-story-generator/contributors [github-release-link]: https://github.com/ChanMeng666/emoji-story-generator/releases [github-license-link]: https://github.com/ChanMeng666/emoji-story-generator/blob/main/LICENSE

[github-release-shield]: https://img.shields.io/github/v/release/ChanMeng666/emoji-story-generator?color=369eff&labelColor=black&logo=github&style=flat-square [python-shield]: https://img.shields.io/badge/Python-3.7+-blue.svg?style=flat-square&logo=python&logoColor=white [streamlit-shield]: https://img.shields.io/badge/Streamlit-latest-FF4B4B.svg?style=flat-square&logo=streamlit&logoColor=white [huggingface-shield]: https://img.shields.io/badge/HuggingFace-Llama--3.1--8B-FFD21E.svg?style=flat-square&logo=huggingface&logoColor=black [github-contributors-shield]: https://img.shields.io/github/contributors/ChanMeng666/emoji-story-generator?color=c4f042&labelColor=black&style=flat-square [github-forks-shield]: https://img.shields.io/github/forks/ChanMeng666/emoji-story-generator?color=8ae8ff&labelColor=black&style=flat-square [github-stars-shield]: https://img.shields.io/github/stars/ChanMeng666/emoji-story-generator?color=ffcb47&labelColor=black&style=flat-square [github-issues-shield]: https://img.shields.io/github/issues/ChanMeng666/emoji-story-generator?color=ff80eb&labelColor=black&style=flat-square [github-license-shield]: https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square

[demo-shield-badge]: https://img.shields.io/badge/🎯%20TRY%20DEMO-LIVE-55b467?labelColor=black&logo=streamlit&style=for-the-badge [community-shield-badge]: https://img.shields.io/badge/💬%20JOIN-COMMUNITY-5865F2?labelColor=black&logo=github&logoColor=white&style=for-the-badge

[share-x-link]: https://x.com/intent/tweet?hashtags=AI,storytelling,emoji,creativity&text=Check%20out%20this%20amazing%20AI-powered%20emoji%20story%20generator!&url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Femoji-story-generator [share-reddit-link]: https://www.reddit.com/submit?title=AI-Powered%20Emoji%20Story%20Generator&url=https%3A%2F%2Fgithub.com%2FChanMeng666%2Femoji-story-generator [share-linkedin-link]: https://linkedin.com/sharing/share-offsite/?url=https://github.com/ChanMeng666/emoji-story-generator

[share-x-shield]: https://img.shields.io/badge/-share%20on%20x-black?labelColor=black&logo=x&logoColor=white&style=flat-square [share-reddit-shield]: https://img.shields.io/badge/-share%20on%20reddit-black?labelColor=black&logo=reddit&logoColor=white&style=flat-square [share-linkedin-shield]: https://img.shields.io/badge/-share%20on%20linkedin-black?labelColor=black&logo=linkedin&logoColor=white&style=flat-square

[deploy-streamlit-link]: https://share.streamlit.io/deploy [deploy-railway-link]: https://railway.app/new/template?template=https://github.com/ChanMeng666/emoji-story-generator [deploy-render-link]: https://render.com/deploy?repo=https://github.com/ChanMeng666/emoji-story-generator

[deploy-streamlit-button]: https://static.streamlit.io/badges/streamlitbadgeblack_white.svg [deploy-railway-button]: https://railway.app/button.svg [deploy-render-button]: https://render.com/images/deploy-to-render-button.svg

[python-link]: https://python.org [streamlit-link]: https://streamlit.io [huggingface-link]: https://huggingface.co </rewritten_file>

🚀 Emoji Story Generator<br/><h3>AI-Powered Creative Storytelling Platform</h3>

📸 Project Screenshots

🎬 Demo Video

TOC

🌟 Introduction

✨ Key Features

1 AI-Powered Story Generation

2 Intelligent Emoji Categorization

* Additional Features

🛠️ Tech Stack

🏗️ Architecture

System Architecture

Component Structure

Data Flow

⚡️ Performance

Performance Metrics

🚀 Getting Started

Prerequisites

Quick Installation

HuggingFace API Setup

🛳 Deployment

Cloud Deployment Options

Local Development Setup

Environment Variables

📖 Usage Guide

Basic Usage

Advanced Features

API Integration

🔌 Integrations

⌨️ Development

Local Development Setup

Code Structure

Adding New Features

🤝 Contributing

How to Contribute

Contribution Ideas

Code Style Guidelines

📄 License

👥 Team

Project Maintainer

`1` AI-Powered Story Generation

`2` Intelligent Emoji Categorization

`*` Additional Features