---
hide:
  - navigation
  - toc
---

<div class="hero-section" markdown>

<div class="zhi-logo" markdown>

<pre>
            ·        ✦
           ╱╲
         ╱━━━━╲
        ╱──────╲
      ╱━━━━━━━━━━╲
     ╱────────────╲
   ╱╱╱    ▐▌    ╲╲╲
  ╱╱╱  ━━━━━━━  ╲╲╲
</pre>

</div>

# zhi CLI

**Terminal AI assistant powered by Chinese LLMs**

zhi is an open-source command-line tool that brings Zhipu GLM models to your terminal. It combines intelligent chat with a powerful skill system for document processing, OCR, and automation — all with built-in safety guardrails.

[Install :material-download:](install.md){ .md-button .md-button--primary }
[Get Started :material-arrow-right:](tutorials.md){ .md-button }
[GitHub :material-github:](https://github.com/chan-kinghin/zhicli){ .md-button }

</div>

---

## Features

<div class="grid cards" markdown>

- :material-brain: **Dual Model Architecture**

    GLM-5 for intelligent chat, GLM-4-flash for cost-effective skill execution (~10% the cost)

- :material-tools: **15 Built-in Skills**

    9 single-purpose + 6 composite workflows for documents, translation, OCR, and more

- :material-file-document: **8 Integrated Tools**

    File read/write, OCR, shell execution, web fetch, skill creation, and interactive prompts

- :material-cog: **YAML Skill System**

    Create custom automation skills in minutes with simple YAML configuration

- :material-translate: **Bilingual Support**

    Full English and Chinese UI with automatic language detection

- :material-shield-check: **Security First**

    No delete capability exists in the architecture — your files can never be removed or overwritten. All output is isolated to zhi-output/, with path traversal protection and shell command confirmation

</div>

---

## Quick Start

```bash
pip install zhicli    # macOS / Linux (requires Python 3.10+)
zhi --setup           # Configure API key (30 seconds)
zhi                   # Start chatting
```

On Windows? [Download standalone exe :material-download:](install.md){ .md-button }  No Python required.
