2. Download, run and system requirements
[!ref] New-user tutorial: a step-by-step walk-through of installing and signing in for the first time is in the Quick Start Guide, "Install and sign in"; this chapter gives the complete per-platform story of system requirements, download and how to run.
2.1 System requirements
| Category | Requirement |
|---|---|
| Operating system | Windows 10 (1809) or later; macOS 12.0 Monterey or later; mainstream Linux (Ubuntu 22.04 / Debian 12 / CentOS Stream 9 or newer) |
| Domestic OS | Kylin desktop V10 SP1 (Kylin-Desktop-V10-SP1-2503); UOS V20 (Uos-Desktop-V20-1060) |
| CPU architecture | x86-64 (64-bit); macOS also supports Apple Silicon (arm64) |
| Runtime dependency | Windows: built-in WebView2 runtime; Linux: webkit2gtk (4.0 / 4.1 — pick the matching build for your distro); macOS: system WebKit, nothing to install |
| RAM | 8 GB minimum, 16 GB recommended |
| Disk | 1 GB free minimum, 2 GB+ recommended (local sessions / skills / logs / code index) |
| Display | 1280 × 720 or higher recommended |
| Network | Internet required on first launch to fetch the model list; day-to-day access to the account service and your chosen model provider (offline-capable features are noted in their chapters) |
2.2 Download and run (install-free)
AVL Code is install-free — download and run, with no installer wizard. From the official download page www.avlcode.cn/#download, pick the build for your platform and run it directly (the beta uses the alpha channel — each platform link always points to the latest build):
| Platform / build | How to run |
|---|---|
| Windows x64 | Download and double-click to run (install-free, no wizard) |
| macOS Universal | Intel and Apple Silicon; drag into Applications and run |
| macOS Apple Silicon (arm64) | Apple Silicon only, smaller; drag into Applications and run |
| Linux x64 | Unpack and run directly |
| Linux AppImage | single-file, no install — chmod +x and run |
| Linux Snap | Snap package (snap install) |
| Linux WebKit 4.1 | newer distros (needs webkit2gtk-4.1) |
| Kylin V10 SP1 | dedicated domestic build (Kylin-Desktop-V10-SP1-2503, x86) |
| UOS V20 | dedicated domestic build (Uos-Desktop-V20-1060) |
- Windows / Linux: download and run — no installation.
- macOS: it's best to drag the app into Applications before running — otherwise, running from "Downloads" / "Desktop", "check for updates" gets locked by macOS App Translocation (see §27.7.2).
- Domestic environments: dedicated builds for Kylin V10 SP1 and UOS V20.
Docs: www.avlcode.cn/docs (User Manual / Quick Start / Reference).
On first launch the app does a brief local initialisation; the process is transparent to the user.
2.3 First launch
After launch you see three main areas:
- Left sidebar: workspace list + sign-in entry + Settings entry.
- Center session area: session tabs + message stream + input box.
- Right floats (on demand): plan / todo, assistant configuration, approval dialogs, etc.
If this is the first launch, click the Sign In button in the lower left to bind your account (see Chapter 3). You can also use it without signing in by entering an API key under Settings → Models.
2.4 Command-line entry points (advanced)
In addition to the desktop app, AVL Code also ships a set of command-line entry points for users who want to script things or work on remote servers. The CLI shares sessions and config with the desktop app; the two can hand work back and forth. The CLI getting-started info and subcommand list live under Settings → Data → Command-line tools.
The TUI subcommands built into the main binary (no extra install required):
| Command | Purpose |
|---|---|
AVL-Code tui |
Launch the TUI version in your terminal, sharing sessions with the desktop |
AVL-Code zagent-tui |
Launch the batch-mode conversation TUI, useful for scripting |