Install kunji

kunji needs Python 3.11 or newer. On Windows you can also use a standalone .exe that doesn’t need Python at all.

Install with pip

Windows

Open Command Prompt or Windows Terminal and run:

python -m pip install kunji

If python isn’t found, try py -m pip install kunji. If neither works, install Python from python.org and tick “Add python.exe to PATH” on the first screen of the installer.

macOS

Open Terminal and run:

python3 -m pip install kunji

Linux

python3 -m pip install --user kunji

If pip says the environment is externally managed (Debian, Ubuntu and others), use pipx instead:

sudo apt install pipx   # or your distro's package manager
pipx install kunji

Check it worked:

kunji --version

“kunji” is not recognized?

pip installed kunji, but its folder isn’t on your PATH. Run kunji through Python instead, which always works:

python -m kunji

See Troubleshooting to fix your PATH permanently.

Windows without Python

1. Download kunji-windows-x64.exe from the latest release.
2. Rename it to kunji.exe and put it in a folder you like, for example C:\Tools.
3. Open a terminal in that folder and run kunji.exe.

To run it from anywhere, add that folder to your PATH (Windows settings → “Edit the system environment variables” → Environment Variables → Path → New).

Linux without Python

Download kunji-linux-x64 from the latest release, then:

chmod +x kunji-linux-x64
./kunji-linux-x64 --version

Check your setup

kunji doctor

doctor checks your Python version, that kunji can save settings, that your OS keychain works, and which providers you’ve added.

Upgrade or uninstall

kunji upgrade                    # newest version
python -m pip uninstall kunji    # remove kunji

Before uninstalling, you can delete your saved keys with kunji keys remove <provider>. More in Upgrade kunji.

Next

Have your first chat →