emoji

Emoji for Python

emoji Permissive license AGING ★ 2,035 v2.15.0 released 2025-09-21

Install

emoji on PyPI

pip

pip install emoji

uv

uv add emoji

poetry

poetry add emoji

Package facts

License	not declared (permissive)
Python support	supports the current Python release (>=3.8)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	aging — 326 days since the last release
Last repo commit	2025-09-21
First released	2014-08-18
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: emoji-2.15.0-py3-none-any.whl

Keywords: emoji

Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Information TechnologyLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Internet :: WWW/HTTP :: Dynamic ContentTopic :: Multimedia :: Graphics :: PresentationTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed

About emoji

from the package's own PyPI description — quoted content, verbatim

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

&gt;&gt;&gt; import emoji
&gt;&gt;&gt; print(emoji.emojize('Python is :thumbs_up:'))
Python is 👍
&gt;&gt;&gt; print(emoji.emojize('Python is :thumbsup:', language='alias'))
Python is 👍
&gt;&gt;&gt; print(emoji.demojize('Python is 👍'))
Python is :thumbs_up:
&gt;&gt;&gt; print(emoji.emojize("Python is fun :red_heart:"))
Python is fun ❤
&gt;&gt;&gt; print(emoji.emojize("Python is fun :red_heart:", variant="emoji_type"))
Python is fun ❤️ #red heart, not black heart
&gt;&gt;&gt; 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...

Read as markdown · JSON record · Source repository

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

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

Low friction: pure Python wheel with no runtime dependencies and active maintenance. Last release 326 days ago with 2035 GitHub stars; repository remains active and not archived.

Permissive license (BSD) allows commercial and private use with minimal restrictions, making it suitable for most projects.

Usage

import emoji
print(emoji.emojize('Python is :thumbs_up:'))
print(emoji.demojize('Python is 👍'))
print(emoji.is_emoji('👍'))

Requires Python 3.8 or later.

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.

Needs verification

Whether the 326-day gap since last release reflects planned maintenance cadence or reduced activity.
Performance characteristics with large text volumes or real-time emoji processing.

emoji unicode conversionemoji code to characterdemojize emojizeemoji text replacementmultilingual emoji supportemoji name lookupemoji alias handler