Desktop app
The desktop app puts the assistant in an ordinary window: double-click, sign in, and start. Nothing else to install, no commands to type.
Current version v0.3.25 · updated 2026-11-08 13:06:55 (UTC)
Which package do I need?
| Platform | Download | Notes |
|---|---|---|
| Windows (x64) | Installer | No Node required; run the installer and follow the prompts |
| macOS (Apple silicon or Intel) | dmg | Open the .dmg and drag ZQAgent into Applications |
| Linux (x64) | AppImage · deb · rpm | Install deb / rpm with the system package manager |
- Windows: download the
.exe, double-click, follow the prompts - macOS: download the
.dmg, open it, drag ZQAgent into Applications - Linux: download
.deb(Ubuntu / Debian) or.rpm(CentOS / Fedora), open it with your software centre
macOS has a single universal package — Apple silicon and Intel both work, no need to check your chip.
All installers are listed in the download directory.
First launch
- Open the app and sign in with your phone number or email (new users get 5 CNY of credit)
- The model is configured automatically — nothing to fill in
- Create a session on the left and describe what you need in the input box
Blocked by the system the first time?
- Windows: "Windows protected your PC" → "More info" → "Run anyway"
- macOS: "cannot verify the developer" → in Applications, right-click → Open → "Open"
The installer hasn't been signed with a paid certificate yet; it isn't a virus. Confirm once and double-clicking works from then on.
Day to day
- Close the window and tasks keep running. It's just hidden — an icon stays in the tray (menu bar on Mac), click it to bring the window back.
- Ready at startup. Once installed it starts with the computer; no manual launching.
- You'll be told about updates; one click installs them.
- What it can see: your home folder by default. You can check the current scope in Settings.
Need the finer details?
Install locations, how the background service runs, where data lives — those are technical details, covered in Install details (technical). Not needed for normal use.
Next
- Getting started: the full path from download to first task
- What it can do: examples you can copy
- FAQ: install problems, connection problems, costs