---
id: kiwipiepy
version: "0.23.2"
license: LGPL v3 License
license_treatment: copyleft
maintenance: active
---

# kiwipiepy — Kiwi, the Korean Tokenizer for Python

License: copyleft · Maintenance: active · Downloads: 346.1K/mo

## What it is and what it does

Kiwipiepy is a Python binding for Kiwi, a Korean morphological analyzer that breaks Korean text into morphemes (smallest meaningful units) and assigns part-of-speech tags based on the Sejong Corpus tagset. It provides tokenization, sentence splitting, stopword filtering, and user dictionary management for customizing analysis on domain-specific vocabulary.

The package ships with prebuilt wheels for modern Python versions (3.9+) on common platforms, reducing installation friction for most users. It depends on numpy, tqdm, and a model data package (kiwipiepy_model) that is automatically installed. The library is actively maintained and supports interactive testing via command-line interface, making it accessible for quick experimentation with Korean text analysis.

Use it for:

- Tokenize Korean documents for natural language processing pipelines and text classification
- Extract morphemes and part-of-speech tags for linguistic analysis or corpus studies
- Split multi-sentence Korean text into individual sentences for batch processing
- Filter stopwords from Korean text before downstream NLP tasks like topic modeling
- Add domain-specific terminology to the analyzer via user dictionary for improved accuracy on specialized corpora

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Kiwipiepy tokenizes and analyzes Korean text into morphemes with part-of-speech tags, sentence splitting, and user dictionary management.

Yes, if you need Korean morphological analysis. The package is actively maintained, has no known vulnerabilities, and offers prebuilt wheels for common platforms. LGPL v3 licensing requires careful review for proprietary use. Medium install friction is acceptable given the compiled nature of the underlying C++ library. Suitable for both research and production Korean NLP pipelines.

## Install

pip install kiwipiepy
uv add kiwipiepy
poetry add kiwipiepy

## Installing kiwipiepy

Before you install: Medium install friction due to compiled C++ components; prebuilt wheels available for Python 3.9+ on major platforms (macOS, Linux, Windows), but source builds require cmake 3.12+ and a C++17 compiler. Active maintenance with recent releases.

License in practice: Licensed under LGPL v3 (copyleft); derivative works and modifications must be distributed under the same license. Suitable for open-source projects but requires careful review for proprietary or closed-source use.

Quickstart:

pip install kiwipiepy
from kiwipiepy import Kiwi
kiwi = Kiwi()
tokens = kiwi.tokenize("안녕하세요 형태소 분석기 키위입니다.")
print(tokens)

Requires cmake 3.12+ if installing from source on platforms without prebuilt wheels; binary distributions available for Python 3.9+ on macOS (10.14+), Linux (manylinux2014), and Windows (Vista+).

Verify before relying:

- Performance characteristics (speed, memory usage) on large-scale Korean text processing
- Accuracy metrics or benchmarks against other Korean tokenizers
- Whether the interactive test mode (python -m kiwipiepy) is suitable for production debugging

## Package facts

- License: LGPL v3 License (copyleft)
- Python support: unspecified
- Install friction: medium
- Maintenance: active
- Downloads: 346.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

korean morphological analysis, korean tokenizer, korean pos tagging, korean text processing, korean nlp library, korean morpheme segmentation, korean sentence splitter, korean-nlp, morphological-analysis, text-processing

[View on SkillFed](https://skillfed.io/packages/kiwipiepy) · [View on PyPI](https://pypi.org/project/kiwipiepy/)