Quickstart

cihai-cli installs the cihai command and works out-of-the-box without configuration.

Run cihai

Choose how you want to invoke the command. uvx runs cihai-cli on demand, pipx runs it through an isolated tool environment, and pip means you already installed the cihai script into your user Python environment.

uvx pipx pip

Configure cooldowns

Run cihai with uvx:

$ uvx --from cihai-cli cihai info 好

$ uvx --from cihai-cli cihai reverse good

$ uvx --from cihai-cli cihai --help

Installation options

Pick the installer that matches how you want to run the command. uvx runs cihai-cli on demand, pipx installs an isolated command, and pip installs it into your user Python environment.

uvx pipx pip

Configure cooldowns

With uvx:

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

Developmental releases

New versions of cihai CLI are published to PyPI as alpha, beta, or release candidates. In their versions you will see notification like a1, b1, and rc1, respectively. 1.10.0b4 would mean the 4th beta release of 1.10.0 before general availability.

• pip:

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

• pipx:

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

  Run that prerelease command as cihai@next:

  $ cihai@next info 好
  

• uv tool install:

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

• uv:

  $ uv add cihai-cli --prerelease allow
  

• uvx:

  $ uvx --from 'cihai-cli' --prerelease allow cihai
  

via trunk (can break easily):

• pip:

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

• uv:

  $ uv add git+https://github.com/cihai/cihai-cli.git#egg=cihai-cli
  

• pipx:

  $ pipx install \
      --suffix=@master \
      --include-deps \
      --force \
      'cihai-cli @ git+https://github.com/cihai/cihai-cli.git@master'
  

Configuration

See cihai’s configuration documentation.