Professional Usage

Regular users: please use the desktop app

If you just want to use AI on your computer to handle files, spreadsheets, and images, go to the Download page and install the desktop app. This page covers command-line, script, and server deployment methods. You need to know how to use a terminal, and if you install the wrong thing it won't even open.

This page is intended for developers, operations teams, and advanced users. Pick any one of the three methods; functionality is identical to the desktop version.

1. Command-Line Version (Single File)

A single-file executable that bundles its own runtime; the target machine does not need Node installed.

Current stable version: v0.3.25 · Build time: 2026-11-08 13:06:55 (UTC)

未能识别你的系统。 请从下面选择对应平台的安装包。

Windows64 位macOSApple 芯片macOSIntel 芯片Linuxx64LinuxARM64

不确定选哪个？第一个通常就对了。

查看支持的系统版本

Platform Notes

Windows — Requires Windows 10 / Server 2016 or later. Windows 7, 8, 8.1, and Server 2008 R2 / 2012 cannot run it, and installing the C++ runtime won't fix that either. See Windows supported versions for details.

The artifact is not Authenticode-signed, so a SmartScreen prompt may appear on first run; choose "More info → Run anyway". Double-click the exe to run it. If you want to type zqagent directly, rename it to zqagent.exe and add it to your PATH.

macOS — The artifact is an executable file without an extension; on first run you must remove the quarantine:

chmod +x zqagent-macos-arm64
xattr -d com.apple.quarantine zqagent-macos-arm64

Want to double-click to install and avoid the terminal? Use the .dmg from the desktop app instead.

Linux — On older systems with glibc below 2.28 (CentOS 7 / Kylin V10, etc.), use the install script below; it automatically selects the glibc 2.17-compatible build.

2. One-Line Install Script (Linux / macOS)

Automatically downloads, verifies, installs, and registers a service that starts on boot:

curl -fsSL https://agent.cd-zq.com/install.sh | sh

If you need to customize the port, the data directory, or explicitly specify the signature-verification public key, download the script first and then run it:

curl -fsSLO https://agent.cd-zq.com/install.sh

# Linux：sudo 装成系统服务；数据默认在运行用户的家目录（~/.zqagent_data）
sudo sh install.sh --port 8787
# 需要放到别处时显式指定（日志会自动跟随）
sudo sh install.sh --port 8787 --data-dir /srv/zqagent

# macOS：默认写入当前用户目录（~/Library/Application Support/zqagent），不需要 sudo
sh install.sh --port 8787

After installation, manage the service with sudo sh -s -- status|logs|restart|rollback|uninstall (drop sudo when installed as a regular user on macOS). See Installation for details.

3. Scripts and API Integration

Purpose	Entry point
npm installation	npm i -g @zqagent/core
Embed as a library	Architecture notes
Multi-tenant node service	REST API
Wire protocol	wire-protocol
MCP external tools	MCP
21 built-in tools	Built-in tools
CLI commands and approval details	CLI usage guide

Version History

正在加载历史版本…

Verifying Downloads

The SHA-256 and size of each version are recorded in the version manifest; use it to verify the files you downloaded:

# 当前版本的清单（JSON）
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.json

# 纯文本形式（平台 版本 URL SHA-256 大小）
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.txt

# 核对已下载文件
sha256sum zqagent-linux-x64