Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chanmeng666/emoji-story-generator

【Sprinkle some star dust on this repo!⭐️】An interactive web application that generates creative stories using AI based on user-selected emoji combinations. Powered by Streamlit and the Zephyr language model.
https://github.com/chanmeng666/emoji-story-generator

artificial-intelligence creative-writing emoji huggingface interactive nlp python story-generation streamlit web-application

Last synced: 3 days ago
JSON representation

【Sprinkle some star dust on this repo!⭐️】An interactive web application that generates creative stories using AI based on user-selected emoji combinations. Powered by Streamlit and the Zephyr language model.

Awesome Lists containing this project

README 

        


 



Emoji Story Generator


 

 

 







Transform your emoji selections into engaging stories with our AI-powered story generator!







[![👉Try It Now!👈](https://gradient-svg-generator.vercel.app/api/svg?text=%F0%9F%91%89Try%20It%20Now!%F0%9F%91%88&color=000000&height=60&gradientType=radial&duration=6s&color0=ffffff&template=pride-rainbow)](https://huggingface.co/spaces/ChanMeng666/emoji-story-generator)







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



![screencapture-huggingface-co-spaces-ChanMeng666-emoji-story-generator-2024-12-23-15_05_47](https://github.com/user-attachments/assets/4b48b701-7528-40c2-91af-9f9997abb822)



# Features



### 🎨 Intuitive Emoji Selection

Browse and select emojis from 8 categorized tabs including emotions, animals, food, activities and more. Simple click-to-add interface with a maximum of 5 emojis per story.



### 🤖 AI-Powered Story Generation

Leverages HuggingFace's Zephyr-7b model to create coherent, creative stories that naturally incorporate your selected emojis into the narrative.



### 📚 Story Library

All generated stories are automatically saved and can be viewed by all users. Includes a voting system to highlight the community's favorite stories.



### 💫 Smart Story Structure

Generated stories follow a clear narrative structure with:

- Beginning: Character and setting introduction

- Middle: Challenge or situation development

- End: Satisfying resolution



### 👥 Community Interaction

Like and vote on stories generated by other users, creating a collaborative creative environment.



## Tech Stack

![Python](https://img.shields.io/badge/python-%2314354C.svg?style=for-the-badge&logo=python&logoColor=white)

![Streamlit](https://img.shields.io/badge/streamlit-%23FF4B4B.svg?style=for-the-badge&logo=streamlit&logoColor=white)

![HuggingFace](https://img.shields.io/badge/huggingface-%23FFD21E.svg?style=for-the-badge&logo=huggingface&logoColor=black)

![dotenv](https://img.shields.io/badge/dotenv-%23000000.svg?style=for-the-badge&logo=dotenv&logoColor=white)



## Getting Started



1. Clone the repository:

```bash

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

cd emoji-story-generator

```



2. Install dependencies:

```bash

pip install -r requirements.txt

```



3. Set up environment variables:

Create a `.env` file in the project root and add your HuggingFace API token:

```bash

HUGGINGFACE_API_TOKEN=your_token_here

```



4. Run the application:

```bash

streamlit run app.py

```



## Usage

1. Select up to 5 emojis from the category tabs

2. Click "Generate Story" to create your story

3. View your generated story and previous stories

4. Vote on stories you enjoy



## Contributing

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



## License

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



## 🙋‍♀ Author



Created and maintained by [Chan Meng](https://github.com/ChanMeng666).