nomiden is a Python package that provides information extraction from Indonesian ID Numbers, i.e. personal ID number NIK (Nomor Induk Kependudukan) and family ID number KK (Kartu Keluarga). This package is intended to help users dealing with population and client data to auto-complete missing data or add valuable information, given the ID numbers. Information regarding identity numbers refers to Article 33 of Government Regulation Number 37 of 2007 (Pasal 37 PP Nomor 37 Tahun 2007).
Here are the things that nomiden can do for you:
- Retreive regional information
- Province
- City
- District
- Retreive gender information (NIK only)
- Retreive birth information (NIK only)
- Age
- Birthday (e.g. 15 June 2000)
- Birth date
- Birth month
- Birth year
- Birth in datetime
- Retreive registration information (KK only)
- Registration day (e.g. 15 June 2000)
- Registration date
- Registration month
- Registration year
- Registration in datetime
- Registration order
- Complete information in a dictionary
The source code is currently hosted on GitHub at: https://github.com/divakartika/nomiden
nomiden is available at the Python Package Index (PyPI).
pip install nomiden
- Python 3.7 and above
- Pandas - Supports data-related operations
https://nomiden.readthedocs.io
This package was built under Python 3.10.8 for Windows 10 and passed the Github Actions: Python package tests under Python 3.8, 3.9, and 3.10 for Ubuntu-latest, MacOS-latest, Windows-latest. To contribute for development, please use requirements.txt.
Region code data used in this package is retrieved from kodewilayah based on the Regulation of the Minister of Home Affairs number 72 of 2019 (Permendagri No. 72 tahun 2019).
Bug fixes and performance improvement.
Return NaN
if birth date (NIK) or registration date (KK) is invalid.
Return NaN
if region code is invalid.
For usage questions and development discussions, feel free to contact diva@algorit.ma.