emot

What it is and what it does

Emot is a Python library that identifies emojis and emoticons within text strings and returns structured data about each match. It parses Unicode emoji characters and ASCII emoticon patterns (like :-) and :-() from input text, reporting the matched symbols, their byte positions, and their semantic meanings in a dictionary with a success flag.

The library generates detection patterns dynamically from an internal emoji database each time an object is instantiated, allowing customization by editing the database file. Version 3.0 added bulk processing functions that use multiprocessing to handle large text datasets, distributing work across available CPU cores (defaulting to half the system total) for potential performance gains on many strings at once.

Use it for:

• Sentiment analysis pipelines that need to extract and interpret emojis as sentiment signals from social media text.
• Content moderation systems that identify and locate emojis or emoticons in user-generated text for filtering or flagging.
• Data preprocessing for NLP tasks where emoji presence or meaning should be captured as features or metadata.
• Bulk text processing of large datasets where extracting all emoji/emoticon occurrences and their positions is required.
• Text annotation or enrichment workflows that map emojis to their Unicode names for downstream analysis or display.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Extracts emojis and emoticons from text, returning their positions, Unicode names, and meanings in a dictionary format.

Yes, if you need straightforward emoji and emoticon extraction with no external dependencies. However, exercise caution: the project is dormant (last release 2021-08-02), the GPL license terms are unclear, and Python version support is unspecified. Suitable for one-off scripts or legacy systems, but risky for new production code without verifying GPL compliance and testing against your target Python version.

Install

emot on PyPI

pip install emot

uv add emot

poetry add emot

Installing emot

Before you install

Low friction install with no runtime dependencies. Maintenance is dormant—last release was 2021-08-02, though the repository remains active with 197 stars and a final commit in 2023-11-02.

License in practice

License treatment is unclear; the raw license states 'GNU GENERAL PUBLIC LICENSE' but no SPDX identifier is provided, making the exact terms and compatibility obligations ambiguous.

Quickstart

import emot
emot_obj = emot.core.emot()
text = "I love python ☮ 🙂 ❤ :-) :-( :-)))"
result = emot_obj.emoji(text)
print(result)  # {'value': ['☮', '🙂', '❤'], 'location': [[14, 15], [16, 17], [18, 19]], 'mean': [':peace_symbol:', ':slightly_smiling_face:', ':red_heart:'], 'flag': True}

Verify before relying

• Whether the GPL license is version 2, 3, or unspecified, and what that means for derivative works or commercial use.
• Current compatibility with modern Python versions and whether Python 3.X support extends to recent releases.
• Whether the multiprocessing bulk functions actually deliver measurable speedup on typical datasets.

Package facts

Evidence: emot-3.1-py3-none-any.whl

Keywords: emoji, emoticons

Tags

More Linguistic packages