Install

Choose your platform to get started with zhi CLI.

---

macOS / Linux

Requires Python 3.10+. Install via pip:

pip install zhicli

Don't have Python?

macOSUbuntu / DebianFedora / RHEL

brew install python@3.11

Or download from python.org.

sudo apt update && sudo apt install python3 python3-pip

sudo dnf install python3 python3-pip

Then configure:

zhi --setup     # Enter your Zhipu API key
zhi             # Start chatting

---

Windows

Option A: Standalone exe (no Python needed)

Download for Windows

The .exe bundles Python — just download, place it in your PATH, and run:

zhi --setup
zhi

Option B: pip install (requires Python 3.10+)

pip install zhicli
zhi --setup
zhi

Installing Python on Windows

Download from python.org and check "Add Python to PATH" during installation.

---

Verify Installation

zhi --version

You should see output like zhi 0.1.19.

---

Get an API Key

zhi requires a Zhipu AI API key. Get one free at open.bigmodel.cn.

zhi --setup    # Guided setup — stores key in ~/.config/zhi/config.yaml

---

Upgrade

pip install --upgrade zhicli

For the Windows exe, download the latest version from this page.