Skip to main content

Python API for CJK datasets. Part of the cihai project.

Project description

cihai - United front to provide open, accessible, and standardized access to CJK data

Python Package Documentation Status Build Status Code Coverage License

In development


  • Single tool for interfacing with CJK data, compare to cjklib.
  • API, in python, for programatically interfacing with data.
  • Compatible with python 2.7, 3.3+, and pypy/pypy3.
  • Designed against a robust test suite. See Travis Builds and Revision History.
  • Supports Unihan, upcoming support for character decomposition, dictionaries (CEDict).
  • Extensible. For new data sets, read more about how you can extend cihai to support new datapackages compatible datasets.
  • For more, see internals for design philosophy.

Workgroup and Standardization

  • Find undigitized data sets relating to CJK
  • Clarifying and negotiate license details of data sets, see permissively licensing your dataset.
  • Create standardized, consistent packages for all data sets
  • Maintain aforementioned datasets
  • Continue to improve current infrastructure and packages while seeking out rare and undigitized CJK data for preservation and access


Python 2.7 and UCS

Note, to get this working on python 2.7, you must have python built with UCS4 via --enable-unicode=ucs4. You can test for UCS4 with:

>>> import sys
>>> sys.maxunicode > 0xffff

Most packaged and included python distributions will already be build with UCS4 (such as Ubuntu’s system python). On python 3.3 and greater, this distinction no longer exists, no action is needed.

Python support Python 2.7, >= 3.3, pypy
Test coverage
License BSD.
git repo
$ git clone
install stable
$ pip install cihai
install dev
$ git clone cihai
$ cd ./cihai
$ virtualenv .env
$ source .env/bin/activate
$ pip install -e .
$ python test

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
cihai-0.3.0.tar.gz (26.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page