Quickstart

Installation

Assure you have at least python >= 3.7.

Using uv:

$ uv add unihan-etl

Run the CLI once without a persistent install via uvx:

$ uvx unihan-etl

Using pip:

$ pip install --user unihan-etl

You can upgrade to the latest release with:

$ pip install --user --upgrade unihan-etl

Developmental releases

New versions of unihan-etl are published to PyPI as alpha, beta, or release candidates. In their versions you will see notification like a1, b1, and rc1, respectively. For example, 0.27.0a1 is the first alpha release of 0.27.0 before general availability.

  • uv:

    $ uv add unihan-etl --prerelease allow

  • pip:

    $ pip install --user --upgrade --pre unihan-etl

  • pipx:

    $ pipx install --suffix=@next 'unihan-etl' --pip-args '\--pre' --force

    Then run unihan-etl@next load [session].

  • uv tool install:

    $ uv tool install --prerelease allow unihan-etl

  • uvx:

    $ uvx --from 'unihan-etl' --prerelease allow unihan-etl

    Then rerun with your desired arguments, e.g. uvx --prerelease allow unihan-etl load [session].

via trunk (can break easily):

  • pip:

    $ pip install --user -e git+https://github.com/cihai/unihan-etl.git#egg=unihan-etl

  • pipx:

    $ pipx install --suffix=@master 'unihan-etl @ git+https://github.com/cihai/unihan-etl.git@master' --force

  • uvx*:

    $ uvx --from git+https://github.com/cihai/unihan-etl.git@master unihan-etl

    *uvx --from lets you run directly from a VCS URL.

Commands

$ unihan-etl

Pythonics

See also

unihan-etl API documentation.