Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
December 12, 2022 00:01
March 12, 2023 21:24
January 5, 2018 19:33
October 1, 2022 01:01
February 8, 2023 17:48
October 31, 2022 14:30
March 12, 2023 21:21
June 30, 2022 19:51
February 8, 2023 17:48


Emoji for Python. This project was inspired by kyokomi.


The entire set of Emoji codes as defined by the Unicode consortium is supported in addition to a bunch of aliases. By default, only the official list is enabled but doing emoji.emojize(language='alias') enables both the full list and aliases.

>>> import emoji
>>> print(emoji.emojize('Python is :thumbs_up:'))
Python is 👍
>>> print(emoji.emojize('Python is :thumbsup:', language='alias'))
Python is 👍
>>> print(emoji.demojize('Python is 👍'))
Python is :thumbs_up:
>>> print(emoji.emojize("Python is fun :red_heart:"))
Python is fun>>> print(emoji.emojize("Python is fun :red_heart:", variant="emoji_type"))
Python is fun ❤️ #red heart, not black heart
>>> print(emoji.is_emoji("👍"))

By default, the language is English (language='en') but also supported languages are:

  • Spanish ('es')
  • Portuguese ('pt')
  • Italian ('it')
  • French ('fr')
  • German ('de')
  • Farsi/Persian ('fa')
  • Indonesian ('id')
  • Simplified Chinese ('zh')
  • Japanese ('ja')
  • Korean ('ko')
>>> print(emoji.emojize('Python es :pulgar_hacia_arriba:', language='es'))
Python es 👍
>>> print(emoji.demojize('Python es 👍', language='es'))
Python es :pulgar_hacia_arriba:
>>> print(emoji.emojize("Python é :polegar_para_cima:", language='pt'))
Python é 👍
>>> print(emoji.demojize("Python é 👍", language='pt'))
Python é :polegar_para_cima:️


Via pip:

$ python -m pip install emoji --upgrade

From master branch:

$ git clone
$ cd emoji
$ python -m pip install .


$ git clone
$ cd emoji
$ python -m pip install -e .\[dev\]
$ pytest

The utils/ is used to generate unicode_codes/ Generally speaking it scrapes a table on the Unicode Consortium's website with BeautifulSoup and prints the contents to stdout as a Python dictionary. For more information take a look in the utils/ file.



Overview of all emoji:

(auto-generated list of the emoji that are supported by the current version of this package)

For English:

Emoji Cheat Sheet

Official Unicode list

For Spanish:

Unicode list

For Portuguese:

Unicode list

For Italian:

Unicode list

For French:

Unicode list

For German:

Unicode list


Taehoon Kim / @carpedm20

Kevin Wurster / @geowurster


Tahir Jalilov / @TahirJalilov