Emoji Learning 📚✨

Learning a new language can be quite challenging, as it often requires leveraging the foundations of languages you already know. To address this challenge and capitalize on a universally understood form of communication, this project harnesses the power of emojis to facilitate language learning for individuals from any cultural background. By integrating the universal appeal of emojis with the proven method of spaced-based repetition learning, this project creates a dynamic deck of cards featuring emojis alongside their descriptions in the language you aspire to learn. These decks are compatible with Anki, the leading spaced-based repetition application and also open source, allowing for a seamless import into your Anki app to kickstart your learning journey.

You can download Anki for free here.

The languages available for learning are:

• Spanish
• English
• French
• German
• Italian
• Portuguese
• Japanese
• Korean
• Chinese
• Persian
• Indonesian

How to Use 🚀

Follow these simple steps to embark on your language learning adventure:

1. Visit the web application at https://emoji-learning.streamlit.app.
2. Select the language you wish to master.
3. Click on 'Generate Deck' to create your personalized learning deck.
4. Download the deck by clicking on 'Download Deck'.
5. Import the downloaded file into your Anki app and begin your learning expedition!

How to Run Locally 🖥️

To run the application on your local machine, clone the repository and set up the environment with these commands:

git clone https://github.com/alexfdez1010/emoji_learning
cd emoji_learning
pip install -r requirements.txt

To launch the app, execute:

streamlit run main.py

Contributing 🤝

We invite and appreciate any contributions to this project! If you're interested in contributing, please fork the repository and submit a pull request with your proposed changes.

License 📝

This project embraces open-source principles and is proudly licensed under the MIT License - for more information, see the LICENSE file.