---
id: emoji
version: "2.15.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# emoji — Emoji for Python

License: permissive · Maintenance: aging · Popularity: top 1,000 on PyPI

## Install

pip install emoji
uv add emoji
poetry add emoji

## Description

Emoji
=====

Emoji for Python.  This project was inspired by `kyokomi <https://github.com/kyokomi/emoji>`__.


Example
-------

The entire set of Emoji codes as defined by the `Unicode consortium <https://unicode.org/emoji/charts/full-emoji-list.html>`__
is supported in addition to a bunch of `aliases <https://www.webfx.com/tools/emoji-cheat-sheet/>`__.  By
default, only the official list is enabled but doing ``emoji.emojize(language='alias')`` enables
both the full list and aliases.

.. code-block:: python

    >>> 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("👍"))
    True

..

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

* Spanish (``'es'``)
* Portuguese (``'pt'``)
* Italian (``'it'``)
* French...

## AI interpretation — verify before relying

Converts between emoji characters and their Unicode code names (e.g., `:thumbs_up:` ↔ `👍`), with support for 13+ languages and emoji aliases.

Verdict: Stable, well-maintained emoji library with zero dependencies, broad language support, and no known vulnerabilities. Suitable for production use in text processing and UI applications requiring emoji-to-code conversion.

[View on SkillFed](https://skillfed.io/packages/emoji) · [View on PyPI](https://pypi.org/project/emoji/)