Skip to main content

Python NLP for Portuguese

Project description


The NLPy_Port is a pipeline assembled from the NLTK pipeline, adding and changing its elements for better processing the portuguese that were previouslly created for the NLPPort pipeline. It suports at the moment the taks of Tokenization, PoS Tagging , Lemmatization and Named Entity Recognition


Installing NLPyPort should be as simple as installing the requirements or installing the module via pip (pip install NLPyPort). However, some other configurations may be necessary.

If your NLTK version is above 3.4.5, install the version 3.4.5 by running:

>>> pip install nltk==3.4.5

If you installed NLTK and do not have downloaded the "Floresta" corpus, run the following commands:

>>> import nltk


In order to simplify the usage of the NLPyPort pipeline, some structural changes were made. The “” file shows exemples os several use cases.

How to use the pipeline

Depending on the planed usage, the pipeline may be called in three different ways:

1 - Default

text = new_full_pipe( your_input_file )

2 - Optional arguments

text = new_full_pipe( your_input_file , options = options )

3 - Optional arguments and pre-load pipeline

config_list = load_congif_to_list()         # Pre-load the pipeline
text=new_full_pipe( your_input_file , options = options , config_list = config_list)

Available options

"tokenizer" : True -> Perform Tokenization

"pos_tagger" : True -> Perform Pos Tagging

"lemmatizer" : True -> Perform Lemmatization

"entity_recognition" : True -> Perform NER

"np_chunking" : True -> Perform NP Chunking

"pre_load" : False -> Preload the pipeline, needs the additional argument “config_list”

"string_or_array" : True -> Set input as being an array or a string

Returned text

In case of success, the pipeline will return an object of the “Text” class. The properties of this are as follow: text.tokens text.pos_tags text.lemas text.entities text.np_tags

Additionally, there is a method to return the pipeline in the CoNNL Format: text.print_conll()

To separate lines , at the end of each line the additional token EOS is added.


Tokenizer and Lemmatizer resource files - Rodrigues, Ricardo, Hugo Gonçalo Oliveira, and Paulo Gomes. "NLPPort: A Pipeline for Portuguese NLP (Short Paper)." 7th Symposium on Languages, Applications and Technologies (SLATE 2018). Schloss Dagstuhl-Leibniz-Zentrum fuer Informatik, 2018.

Lemmatizer design - Rodrigues, Ricardo, Hugo Gonçalo Oliveira, and Paulo Gomes. "LemPORT: a high-accuracy cross-platform lemmatizer for portuguese." 3rd Symposium on Languages, Applications and Technologies. Schloss Dagstuhl-Leibniz-Zentrum fuer Informatik, 2014.

PoS trainer (adapted from) -

Named Entity Recognition
CRF suite - Naoaki Okazaki sklearn-crfsuite wrapper -

Corpus Corpus for PoS tagging training MacMorpho - Floresta Sintá(c)tica -


To cite and give credits to the pipeline please use the following BibText reference:

@inproceedings{ferreira_etal:slate2019, Author = {João Ferreira and Hugo {Gonçalo~Oliveira} and Ricardo Rodrigues}, Booktitle = {Symposium on Languages, Applications and Technologies (SLATE 2019)}, Month = {June}, Note = {In press}, Title = {Improving {NLTK} for Processing {P}ortuguese}, Year = {2019}}

Project details

Download files

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

Source Distribution

NLPyPort-2.2.5.tar.gz (42.7 MB view hashes)

Uploaded source

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