cihai-cli ·

Command line interface to the cihai CJK-language library.

This project is under active development. Follow our progress and check back for updates!

Installation

$ pip install --user cihai-cli

Or manage it inside an existing project with uv:

$ uv add cihai-cli

Install the CLI as a user-wide tool with uv:

$ uv tool install cihai-cli

Run it on-demand without installing:

$ uvx --from cihai-cli cihai --version

Developmental releases

You can test the unpublished version of cihai-cli before its released.

pip:

$ pip install --user --upgrade --pre cihai-cli

uv:

$ uv tool install --prerelease=allow cihai-cli

$ uv add --prerelease=allow cihai-cli

pipx:

$ pipx install --suffix=@next cihai-cli --pip-args '\--pre' --include-deps --force

Then use cihai@next info 好.

For more information see developmental releases

Character lookup

See CLI in the documentation for full usage information.

$ cihai info 好

char: 好
kCantonese: hou2 hou3
kDefinition: good, excellent, fine; well
kHangul: 호
kJapaneseOn: KOU
kKorean: HO
kMandarin: hǎo
kTang: "*xɑ̀u *xɑ̌u"
kTotalStrokes: "6"
ucn: U+597D

Retrieve all character information (including book indices):

$ cihai info 好 -a

char: 好
kCangjie: VND
kCantonese: hou2 hou3
kCihaiT: "378.103"
kDefinition: good, excellent, fine; well
kFenn: 552A
kFourCornerCode: "4744.7"
kFrequency: "1"
kGradeLevel: "1"
kHKGlyph: 0871
kHangul: 호
kHanyuPinlu: hǎo(6060) hāo(142) hào(115)
kHanyuPinyin: 21028.010:hǎo,hào
kJapaneseKun: KONOMU SUKU YOI
kJapaneseOn: KOU
kKorean: HO
kMandarin: hǎo
kPhonetic: "481"
kRSAdobe_Japan1_6: C+1975+38.3.3 C+1975+39.3.3
kRSKangXi: "38.3"
kTang: "*xɑ̀u *xɑ̌u"
kTotalStrokes: "6"
kVietnamese: háo
kXHC1983: 0445.030:hǎo 0448.030:hào
ucn: U+597D

Reverse lookup

$ cihai reverse library

char: 圕
kCantonese: syu1
kDefinition: library
kJapaneseOn: TOSHOKAN SHO
kMandarin: tú
kTotalStrokes: '13'
ucn: U+5715
--------
char: 嫏
kCantonese: long4
kDefinition: the place where the supreme stores his books; library
kJapaneseOn: ROU
kMandarin: láng
kTotalStrokes: '11'
ucn: U+5ACF
--------

Developing

$ git clone https://github.com/cihai/cihai-cli.git

$ cd cihai-cli

Bootstrap your environment and learn more about contributing. We use the same conventions / tools across all cihai projects: pytest, sphinx, mypy, ruff, tmuxp, and file watcher helpers (e.g. entr(1)).

Python versions

Final Python 3.7 version: 0.16.0

Release files for cihai-cli 0.34.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cihai-cli 0.34.0
File	Size	Uploaded
cihai_cli-0.34.0.tar.gz	230.1 kB	Jun 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cihai-cli 0.34.0
File	Interpreter	ABI	Platform	Reset
cihai_cli-0.34.0-py3-none-any.whl 11.0 kB Jun 29, 2026	Python 3	none	any	Details

Total release size: 241.1 kB

Release files / cihai_cli-0.34.0.tar.gz

Download URL	cihai_cli-0.34.0.tar.gz
Size	230.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`751a2311e91d7616694c4a9b77a44f2c4302c35180dd9343b5fdaf9f863ab2ae`
BLAKE2b-256 checksum How to use checksums	`12a328843d5d46eb5a6145cf4802f0bec1bcae96bc24b04d236a78f32013b67f`
Upload date	Jun 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cihai/cihai-cli
Publishing commit: github.com/cihai/cihai-cli/tree/6405115784f14ccc5cdcd909f00435cbe36d4e29

Workflow

Publishing configuration: github.com/cihai/cihai-cli/blob/6405115784f14ccc5cdcd909f00435cbe36d4e29/.github/workflows/tests.yml
Publishing logs: github.com/cihai/cihai-cli/actions/runs/28345510819/attempts/1

Artifact

Subject: cihai_cli-0.34.0.tar.gz
SHA-256 checksum: 751a2311e91d7616694c4a9b77a44f2c4302c35180dd9343b5fdaf9f863ab2ae Verifying attestations

Release files / cihai_cli-0.34.0-py3-none-any.whl

Download URL	cihai_cli-0.34.0-py3-none-any.whl
Size	11.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b8b20ea2bc988f98ccae7d86e65d41d5695f1d0bd25fec91b9ba568d0625a342`
BLAKE2b-256 checksum How to use checksums	`2594e51b1bd3a998c7dab01256c24aacaf9264fd5e3a7f1ed546d54f7200dda2`
Upload date	Jun 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cihai/cihai-cli
Publishing commit: github.com/cihai/cihai-cli/tree/6405115784f14ccc5cdcd909f00435cbe36d4e29

Workflow

Publishing configuration: github.com/cihai/cihai-cli/blob/6405115784f14ccc5cdcd909f00435cbe36d4e29/.github/workflows/tests.yml
Publishing logs: github.com/cihai/cihai-cli/actions/runs/28345510819/attempts/1

Artifact

Subject: cihai_cli-0.34.0-py3-none-any.whl
SHA-256 checksum: b8b20ea2bc988f98ccae7d86e65d41d5695f1d0bd25fec91b9ba568d0625a342 Verifying attestations