---
id: pyicu
version: "2.16.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyicu — Python extension wrapping the ICU C++ API

License: permissive · Maintenance: active · Downloads: 681.6K/mo

## What it is and what it does

PyICU is a Python extension that wraps the ICU (International Components for Unicode) C++ libraries, providing direct access to the Unicode Consortium's internationalization and localization tools. It implements much of the Unicode Standard, Unicode Technical Standards, and Unicode CLDR, enabling developers to handle text processing tasks that require locale awareness, proper collation, script detection, and multilingual support.

The package is used when you need production-grade Unicode and internationalization features beyond Python's built-in string handling. It handles collation, number and date formatting in different locales, text normalization, bidirectional text, script detection, and other complex text operations. Because PyICU is a C++ extension wrapping native libraries, it offers performance and feature completeness that pure-Python alternatives cannot match, but at the cost of requiring system-level ICU installation and compilation during setup.

Use it for:

- Sort user-generated text correctly in different languages using locale-aware collation rules
- Format dates, times, and numbers according to regional conventions for international applications
- Normalize Unicode text and detect script boundaries in multilingual documents
- Build search and filtering systems that respect language-specific text comparison rules
- Process bidirectional text and handle complex script combinations

## Worth the install?

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

PyICU wraps the ICU C++ libraries to provide Python access to Unicode text processing, internationalization, and localization features including collation, formatting, and script handling.

Yes, if you need production-grade internationalization and Unicode handling. PyICU is stable (Production/Stable status, active maintenance, no known vulnerabilities) and widely used. Install only if your system can satisfy the high build-time friction: pre-built packages exist for major platforms, but source builds require ICU libraries, pkg-config, and a matching C++ compiler. Avoid if you need a pure-Python solution or cannot install system dependencies.

## Install

pip install pyicu
uv add pyicu
poetry add pyicu

## Installing pyicu

Before you install: Installation requires high friction: the ICU C++ libraries and headers must be pre-installed on your system, and PyICU builds from source rather than offering pre-built wheels on all platforms. Pre-built packages are available on macOS (Homebrew, Macports), Debian, Ubuntu, Alpine, NetBSD, and OpenBSD; building from source requires pkg-config and a C++ compiler matching your Python distribution.

License in practice: PyICU is licensed under MIT, a permissive open-source license that allows commercial and private use with minimal restrictions.

Quickstart:

# After installing ICU libraries and PyICU
import pyicu

# Create a collator for locale-aware string comparison
locale = pyicu.Locale('en_US')
collator = pyicu.Collator.createInstance(locale)
result = collator.compare('apple', 'Apple')

The ICU C++ libraries and development headers must be installed on your system before installing PyICU. On macOS, this typically requires Homebrew or Macports; on Linux, the libicu-dev package; on Windows, manual ICU installation. The C++ compiler used must match your Python distribution's compiler.

Verify before relying:

- Whether pre-built wheels are available for the current version on PyPI for common platforms
- Current maintenance activity and response time for issues on the GitLab repository
- Performance characteristics compared to pure-Python Unicode libraries for typical workloads
- Specific API surface and feature completeness relative to native ICU C++ library

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: active
- Downloads: 681.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

unicode text processing python, internationalization i18n library, collation and sorting unicode, locale-aware formatting, icu bindings python, multilingual text handling, unicode normalization, unicode-processing, internationalization, c-extension

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