Skip to main content

FEEL-IT: Emotion and Sentiment Classification for the Italian Language

https://img.shields.io/pypi/v/feel_it.svg https://github.com/MilaNLProc/feel-it/workflows/Python%20package/badge.svg License Colab Tutorial Medium Blog Post

Abstract

Sentiment analysis is a common task to understand people’s reactions online. Still, we often need more nuanced information: is the post negative because the user is angry or because they are sad?

An abundance of approaches has been introduced for tackling both tasks. However, at least for Italian, they all treat only one of the tasks at a time. We introduce FEEL-IT, a novel benchmark corpus of Italian Twitter posts annotated with four basic emotions: anger, fear, joy, sadness. By collapsing them, we can also do sentiment analysis. We evaluate our corpus on benchmark datasets for both emotion and sentiment classification, obtaining competitive results.

We release an open-source Python library, so researchers can use a model trained on FEEL-IT for inferring both sentiments and emotions from Italian text.

License

Code comes from HuggingFace and thus our License is an MIT license.

For models restrictions may apply on the data (which are derived from existing datasets) or Twitter (main data source). We refer users to the original licenses accompanying each dataset and Twitter regulations.

Data Access

Send us an email :)

Features

  • Emotion Classification (fear, joy, sadness, anger) in Italian

  • Sentiment Classification (positive, negative) in Italian

Installing

pip install -U feel-it

Jump start Tutorials

Name

Link

Sentiment and Emotion Classification (stable v1.0.2)

Colab Tutorial

How To Use

The two classifiers are very easy to use. You can also directly use our colab tutorial!

from feel_it import EmotionClassifier, SentimentClassifier

emotion_classifier = EmotionClassifier()

emotion_classifier.predict(["sono molto felice", "ma che cazzo vuoi", "sono molto triste"])
>> ['joy', 'anger', 'sadness']

sentiment_classifier = SentimentClassifier()

sentiment_classifier.predict(["sono molto felice", "ma che cazzo vuoi", "sono molto triste"])
>> ['positive', 'negative', 'negative']

Citation

Please use the following bibtex entry if you use this model in your project:

@inproceedings{bianchi2021feel,
  title = {{"FEEL-IT: Emotion and Sentiment Classification for the Italian Language"}},
  author = "Bianchi, Federico and Nozza, Debora and Hovy, Dirk",
  booktitle = "Proceedings of the 11th Workshop on Computational Approaches to Subjectivity, Sentiment and Social Media Analysis",
  year = "2021",
  publisher = "Association for Computational Linguistics",
}

HuggingFace Models

You can find our HF Models here:

Name

Link

MilaNLProc/feel-it-italian-emotion

Emotion Model

MilaNLProc/feel-it-italian-sentiment

Sentiment Model

Development Team

Note

Remember that this is a research tool :)

Other Resources

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

1.0.3 (2021-03-18)

  • Release with starting documentation

0.1.0 (2021-03-17)

  • First release on PyPI.

Metadata

Release files for feel-it 1.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for feel-it 1.0.5
File Size Uploaded
feel_it-1.0.5.tar.gz 13.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for feel-it 1.0.5
File Interpreter ABI Platform
feel_it-1.0.5-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 19.8 kB

Release files / feel_it-1.0.5.tar.gz

Download URL feel_it-1.0.5.tar.gz
Size 13.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8312420f7aff9dcfd0f3b90710729e9cff87ddf5d2f08d7fd8064a74999c6f23
BLAKE2b-256 checksum
How to use checksums
081382a0d7b71217ee40e37e03827a30012f85102c89fb3e37db724e54318ed9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.16

Release files / feel_it-1.0.5-py2.py3-none-any.whl

Download URL feel_it-1.0.5-py2.py3-none-any.whl
Size 6.1 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
8df7bbdcff8f6d2dfc0170283034148572dabcc4299e9faefec3a25be0ded314
BLAKE2b-256 checksum
How to use checksums
5fa51092734c0dad01ab76b39222e67334559380a9c62141317646c0dfb331a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.16

Release history Release notifications | RSS feed

This release

1.0.5 This release

2 release files

1.0.4

1 release file

1.0.3

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page