eKoNLPy
eKoNLPy is a Python library for Korean text processing in economic and financial research. It provides a MeCab based tagger with an economic vocabulary and lexicon based sentiment analyzers for Korean and English text.
This documentation follows the repository source, which may include unreleased changes. Published versions are listed on PyPI.
Install
python -m pip install ekonlpy
eKoNLPy supports Python 3.9 or newer, below Python 4. The main CI matrix tests Python 3.12-3.14 on Linux, macOS, and Windows, and Python 3.9-3.11 on Linux. For Jupyter or Colab, install into the active kernel:
%pip install ekonlpy
Quick start
from ekonlpy import Mecab
tagger = Mecab()
print(tagger.pos("금통위는 금리정책을 결정했다."))
The default tagger applies eKoNLPy's extended vocabulary. Use
Mecab(use_original_tagger=True) for the underlying fugashi/MeCab tagger.
Instances keep their dictionaries, synonyms, and lemmas separate from one
another. See the documentation for tagging,
custom vocabularies, sentiment analyzers, and the CLI.
Sentiment example
from ekonlpy.sentiment import MPKO
analyzer = MPKO(kind=1)
tokens = analyzer.tokenize("금리 인상이 필요하다")
print(analyzer.get_score(tokens))
The sentiment package also exports EUKO, KSA, HIV4, LM, and MPCK.
KSA uses KoNLPy's Java backed Kkma tokenizer and is optional. The separate
KOSAC analyzer is another optional KoNLPy integration.
Development
make install
make check
make test
make docs-test
Contributions and issue reports are welcome on GitHub. For project documentation and verification steps, see the contributing guide.
License and citation
eKoNLPy is released under the MIT License. Research users can cite the project and the monetary policy text mining paper listed in the contributing and citation notes.
1 maintainer
Release files for eKoNLPy 2.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ekonlpy-2.2.3.tar.gz | 19.7 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ekonlpy-2.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 30.0 MB
Release files / ekonlpy-2.2.3.tar.gz
| Download URL | ekonlpy-2.2.3.tar.gz |
|---|---|
| Size | 19.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0219c88007a292234fe6f0b2f67d55509aceed404818b62edd71ea1bf263822a
|
|
BLAKE2b-256 checksum How to use checksums |
4b8c910d19979b721ef196d6a34f49824bf16adbf4d2deb14681719cdb2f81be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.
Transparency logRelease files / ekonlpy-2.2.3-py3-none-any.whl
| Download URL | ekonlpy-2.2.3-py3-none-any.whl |
|---|---|
| Size | 10.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
686c7c1f375439afd1495cdf63f5f6114daf0deae58e00e4ed35deaed3692ceb
|
|
BLAKE2b-256 checksum How to use checksums |
efb8d19a8f327601752ed7e76c9740baabc0763cafd6fa500b905c951574f8bf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.
Transparency log
