Skip to main content

kumparan's NLP Services

nlp-id is a collection of modules which provides various functions for Natural Language Processing for Bahasa Indonesia. This repository contains all source code related to NLP services.

Installation

To install nlp-id, use the following command:

$ pip install nlp-id     

Usage

Description on how to use the lemmatizer, tokenizer, POS-tagger, etc. will be explained in more detail in this section.

Lemmatizer

Lemmatizer is used to get the root words from every word in a sentence.

from nlp_id.lemmatizer import Lemmatizer 
lemmatizer = Lemmatizer() 
lemmatizer.lemmatize('Saya sedang mencoba') 
# saya sedang coba 

Tokenizer

Tokenizer is used to convert text into tokens of word, punctuation, number, date, email, URL, etc. There are two kinds of tokenizer in this repository, standard tokenizer and phrase tokenizer. The standard tokenizer tokenizes the text into separate tokens where the word tokens are single-word tokens. Tokens that started with ku- or ended with -ku, -mu, -nya, -lah, -kah will be split if it is personal pronoun or particle.

from nlp_id.tokenizer import Tokenizer 
tokenizer = Tokenizer() 
tokenizer.tokenize('Lionel Messi pergi ke pasar di daerah Jakarta Pusat.') 
# ['Lionel', 'Messi', 'pergi', 'ke', 'pasar', 'di', 'daerah', 'Jakarta', 'Pusat', '.']

tokenizer.tokenize('Lionel Messi pergi ke rumahmu di daerah Jakarta Pusat.') 
# ['Lionel', 'Messi', 'pergi', 'ke', 'rumah', 'mu', 'di', 'daerah', 'Jakarta', 'Pusat', '.']

The phrase tokenizer tokenizes the text into separate tokens where the word tokens are phrases (single or multi-word tokens).

from nlp_id.tokenizer import PhraseTokenizer 
tokenizer = PhraseTokenizer() 
tokenizer.tokenize('Lionel Messi pergi ke pasar di daerah Jakarta Pusat.') 
# ['Lionel Messi', 'pergi', 'ke', 'pasar', 'di', 'daerah', 'Jakarta Pusat', '.']

POS Tagger

POS tagger is used to obtain the Part-Of-Speech tag from a text. There are two kinds of POS tagger in this repository, standard POS tagger and phrase POS tagger. The tokens in standard POS Tagger are single-word tokens, while the tokens in phrase POS Tagger are phrases (single or multi-word tokens).

from nlp_id.postag import PosTag
postagger = PosTag() 
postagger.get_pos_tag('Lionel Messi pergi ke pasar di daerah Jakarta Pusat.') 
# [('Lionel', 'NNP'), ('Messi', 'NNP'), ('pergi', 'VB'), ('ke', 'IN'), ('pasar', 'NN'), ('di', 'IN'), ('daerah', 'NN'),  
  ('Jakarta', 'NNP'), ('Pusat', 'NNP'), ('.', 'SYM')]

postagger.get_phrase_tag('Lionel Messi pergi ke pasar di daerah Jakarta Pusat.') 
# [('Lionel Messi', 'NP'), ('pergi', 'VP'), ('ke', 'IN'), ('pasar', 'NN'), ('di', 'IN'), ('daerah', 'NN'), 
  ('Jakarta Pusat', 'NP'), ('.', 'SYM')]

Description of tagset used for POS Tagger:

No. Tag Description Example
1 ADV Adverbs. Includes adverb, modal, and auxiliary verb sangat, hanya, justru, boleh, harus, mesti
2 CC Coordinating conjunction. Coordinating conjunction links two or more syntactically equivalent parts of a sentence. Coordinating conjunction can link independent clauses, phrases, or words. dan, tetapi, atau
3 DT Determiner/article. A grammatical unit which limits the potential referent of a noun phrase, whose basic role is to mark noun phrases as either definite or indefinite. para, sang, si, ini, itu, nya
4 FW Foreign word. Foreign word is a word which comes from foreign language and is not yet included in Indonesian dictionary workshop, business, e-commerce
5 IN Preposition. A preposition links word or phrase and constituent in front of that preposition and results prepositional phrase. dalam, dengan, di, ke
6 JJ Adjective. Adjectives are words which describe, modify, or specify some properties of the head noun of the phrase bersih, panjang, jauh, marah
7 NEG Negation tidak, belum, jangan
8 NN Noun. Nouns are words which refer to human, animal, thing, concept, or understanding meja, kursi, monyet, perkumpulan
9 NNP Proper Noun. Proper noun is a specific name of a person, thing, place, event, etc. Indonesia, Jakarta, Piala Dunia, Idul Fitri, Jokowi
10 NUM Number. Includes cardinal and ordinal number 9876, 2019, 0,5, empat
11 PR Pronoun. Includes personal pronoun and demonstrative pronoun saya, kami, kita, kalian, ini, itu, nya, yang
12 RP Particle. Particle which confirms interrogative, imperative, or declarative sentences pun, lah, kah
13 SC Subordinating Conjunction. Subordinating conjunction links two or more clauses and one of the clauses is a subordinate clause. sejak, jika, seandainya, dengan, bahwa
14 SYM Symbols and Punctuations +,%,@
15 UH Interjection. Interjection expresses feeling or state of mind and has no relation with other words syntactically. ayo, nah, ah
16 VB Verb. Includes transitive verbs, intransitive verbs, active verbs, passive verbs, and copulas. tertidur, bekerja, membaca
17 ADJP Adjective Phrase. A group of words headed by an adjective that describes a noun or a pronoun sangat tinggi
18 DP Date Phrase. Date written with whitespaces 1 Januari 2020
19 NP Noun Phrase. A phrase that has a noun (or indefinite pronoun) as its head Jakarta Pusat, Lionel Messi
20 NUMP Number Phrase. 10 juta
21 VP Verb Phrase. A syntactic unit composed of at least one verb and its dependents tidak makan

Stopword

nlp-id also provide list of Indonesian stopword.

from nlp_id.stopword import StopWord 
stopword = StopWord() 
stopword.get_stopword() 
# [{list_of_nlp_id_stopword}]    

Stopword Removal is used to remove every Indonesian stopword from the given text.

from nlp_id.stopword import StopWord 
text = "Lionel Messi pergi Ke pasar di area Jakarta Pusat" # single sentence
stopword = StopWord() 
stopword.remove_stopword(text)
# Lionel Messi pergi pasar area Jakarta Pusat  

paragraph = "Lionel Messi pergi Ke pasar di area Jakarta Pusat itu. Sedangkan Cristiano Ronaldo ke pasar Di area Jakarta Selatan. Dan mereka tidak bertemu begini-begitu."
stopword.remove_stopword(paragraph)
# Lionel Messi pergi pasar area Jakarta Pusat. Cristiano Ronaldo pasar area Jakarta Selatan. bertemu.

Training and Evaluation

Our model is trained using stories from kumparan as the dataset. We managed to get ~93% accuracy on our test set.

Citation

DOI

Metadata

Release files for nlp-id 0.1.23.0

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

Source distribution (sdist)

Source distribution for nlp-id 0.1.23.0
File Size Uploaded Provenance Actions
nlp_id-0.1.23.0.tar.gz 7.9 MB Without provenance Details for nlp_id-0.1.23.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nlp-id 0.1.23.0
File Interpreter ABI Platform Actions
nlp_id-0.1.23.0-py3-none-any.whl Python 3 none any Details for nlp_id-0.1.23.0-py3-none-any.whl

Total release size: 15.9 MB

Release files / nlp_id-0.1.23.0.tar.gz

Download URL nlp_id-0.1.23.0.tar.gz
Size 7.9 MB
Tags Source
SHA-256 checksum
How to use checksums
e740ccf4cb59a187b54e4c5cf5ba26936d3045a6802e35803ba515ebba9bc18b
BLAKE2b-256 checksum
How to use checksums
923373bbb3d4cd004014d0492ee7bec8bdaf98ca81e310f18b69c77cbc52396b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.3.3 CPython/3.14.3 Darwin/25.3.0

Release files / nlp_id-0.1.23.0-py3-none-any.whl

Download URL nlp_id-0.1.23.0-py3-none-any.whl
Size 8.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
358faafb1e4801d79d6c9c8cf20be9d62d990fff9563f2bb6ee1cd7731691384
BLAKE2b-256 checksum
How to use checksums
a963ee0e9d7079f1b11c0ddbb0f400f9008bec5089e49155031c589282f1b4e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.3.3 CPython/3.14.3 Darwin/25.3.0

Security for nlp-id 0.1.23.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.23.0 This release

2 release files No provenance

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