Getting Started (no code required)
If you just want AI to handle files, spreadsheets, and images on your computer — rather than write programs — this page is for you.
You will not need to: install anything extra, fill in any settings, type any commands, or read any error logs.
Already have your own model key, or want to avoid platform credit? See Use your own key. Prefer the command line? See Advanced usage.
Step 1: Download
Open the download page and pick the build for your system.
| Your computer | Choose | Notes |
|---|---|---|
| Windows 10 / 11 | Windows installer (.exe) | Double-click and follow the prompts |
| Linux | deb (Ubuntu / Debian) or rpm (CentOS / Fedora) | Open it with your software centre |
| macOS | dmg (universal) | Open the .dmg and drag ZQAgent into Applications |
macOS users
There is a single universal macOS build that works on both Apple silicon and Intel Macs, so you do not need to check your chip. The desktop build bundles its own runtime, so there is no need to install anything extra or touch a terminal.
What if the system blocks the first launch?
- Windows shows "Windows protected your PC" → click More info → Run anyway.
- This happens because the installer is not signed with a paid certificate. It is not malware.
Step 2: Sign in
After opening the app, you will see a sign-in window. Sign in once; you will not be asked again.
- The model is configured automatically — there is nothing for you to fill in.
- New users receive 5 CNY of credit and can start immediately without paying.
- When credit runs out, you can top up inside the app.
What does 5 CNY cover?
As a rough estimate, it covers well over a hundred simple file-processing tasks. The exact amount depends on task complexity and file count. You can check your balance at any time in the app.
Step 3: Ask it to do something
No commands to memorize. Describe what you want the way you would say it to a colleague, then press Enter.
Three things make a good request: where the files are, what to do, where the result goes.
Vague: tidy up my files
Better: Take every screenshot (png and jpg) in ~/Downloads, rename them by
modified time, and move them to ~/Pictures/screenshots/Eight tasks you can copy as-is
Rename by date
Rename every image in ~/Downloads using its capture date, like 2024-05-01_001.jpg
Merge spreadsheets
Merge all xlsx files in ~/reports into one sheet, keep a single header row, sort by date
Compress images
Compress every image over 2MB in ~/photos down to 500KB, keeping the originals
Convert formats
Convert every png in ~/assets to webp at quality 85
Extract from PDFs
Read the PDFs in ~/contracts and extract party names, amounts, and signing dates into one Excel file
Find duplicates
Find images in ~/Pictures with identical content and list them for me — do not delete anything yet
Search documents
Find every paragraph mentioning "penalty" across the Word files in ~/docs and quote them
Batch add prefixes
Add the prefix today_ to every file name in ~/project
It asks before touching your files
This is the main difference from a chat window: it really operates on your computer, so every change passes a checkpoint.
🔒 Approval required
┌─────────┬────────────────────────────────┐
│ 🔧 Tool │ replace_in_file │
│ 📄 File │ ~/notes/todo.txt │
│ old │ Todo: write weekly report │
│ new │ Todo: write weekly report (done) │
└─────────┴────────────────────────────────┘
[Y] Allow once [A] Always allow [D] Deny| Key | Meaning | When to use |
|---|---|---|
| Y | Allow this once | The default; safest choice |
| A | Always allow this kind of action | Only when you are sure it will not get it wrong |
| D | Deny | It misunderstood, or you do not want this file changed |
If you do not understand what it is about to do, press D. Denying has no side effects; you can rephrase and try again.
Common concerns
Will it delete my files?
Not on its own. Deletion is irreversible and always requires a separate confirmation. You can ask it to "just list them, do not touch anything" first.
Can it see everything on my computer?
Only files inside the folder you choose (your home directory by default). Anything outside requires your permission. Your files are not uploaded wholesale — only the passages it needs to read are sent to the model.
Does it cost money?
New users get 5 CNY, enough to decide whether it is useful to you. After that you can either top up platform credit, or switch to your own model key and pay the provider directly. Single-machine use does not require a device plan.
How is credit counted?
By actual usage — a routine task usually costs under a cent — with no subscription lock-in. Balance and usage details are visible on the account page in the app.
What if it gets something wrong?
- Type additional instructions while a task is running — no need to wait
- Press
ESCtwice to interrupt - The approval prompt is your last checkpoint before any file changes; deny if unsure
Next
- Built-in tools: what it can and cannot do
- FAQ: more details
- Desktop app: tray, autostart, where data lives