Skip to main content

Semantic Textual Similarity and Dialogue System package for Python

Project description


ASAPPpy is a Python package for developing models to compute the Semantic Textual Similarity (STS) between texts in Portuguese. These models follow a supervised learning approach to learn an STS function from annotated sentence pairs, considering a variety of lexical, syntactic, semantic and distributional features.

ASAPPpy can also be used to develop STS based dialogue agents and deploy them to Slack.


If you want to contribute to this project, please follow the Google Python Style Guide.


Before getting started, verify that pip >= 20.3.3. If not, update it with this command:

pip install --upgrade pip

To install the latest version of ASAPPpy use the following command:

pip install ASAPPpy

After finishing the installation, you might need to download the word embeddings models. Given that they were obtained from various sources, we collected them and they can be downloaded at once by running the Python interpreter in your terminal followed by these commands:

import ASAPPpy

Finally, if you have never used spaCy before and you want to use the dependency parsing features, you will need to run the next command in the terminal:

python -m spacy download pt_core_news_sm

Alternatively, you can check the latest version of ASAPPpy using this command:

git clone

Project History

ASAP(P) is the name of a collection of systems developed by the Natural Language Processing group at CISUC for computing STS based on a regression method and a set of lexical, syntactic, semantic and distributional features extracted from text. It was used to participate in several STS evaluation tasks, for English and Portuguese, but was only recently integrated into two single independent frameworks: ASAPPpy (available here), in Python, and ASAPPj, in Java.

Help and Support


Coming soon...


If you have any questions feel free to open a new issue and we will respond as soon as possible.


When citing ASAPPpy in academic papers and theses, please use the following BibTeX entry:

    title = {ASAPPpy: a Python Framework for Portuguese STS},
    author = {José Santos and Ana Alves and Hugo {Gonçalo Oliveira}},
    url = {},
    year = {2020},
    date = {2020-01-01},
    booktitle = {Proceedings of the ASSIN 2 Shared Task: Evaluating Semantic Textual Similarity and Textual Entailment in Portuguese},
    volume = {2583},
    pages = {14--26},
    publisher = {},
    series = {CEUR Workshop Proceedings},
    keywords = {aia, asap, sts},
    pubstate = {published},
    tppubtype = {inproceedings}

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ASAPPpy, version 0.2b1
Filename, size File type Python version Upload date Hashes
Filename, size ASAPPpy-0.2b1.tar.gz (2.6 MB) File type Source Python version None Upload date Hashes View
Filename, size ASAPPpy-0.2b1-py3-none-any.whl (2.7 MB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page