Download
The build for this computer is highlighted.
| Platform | What |
|---|---|
| macOS | .dmg for Apple Silicon (M1 and later) Macs. There is no Intel Mac build. |
| Windows | Installer .exe for 64-bit Windows. |
Install and first launch
macOS
- Open the downloaded
.dmgand drag Gradient into the Applications folder. - Open Gradient from Applications.
- If macOS says it can't be opened, go to System Settings › Privacy & Security and choose “Open Anyway” next to Gradient. This build is not yet OS code-signed, so this check is needed once.
Windows
- Run the downloaded installer and follow the steps.
- If “Windows protected your PC” appears, choose “More info” → “Run anyway”. This build is not yet OS code-signed, so this check is needed once.
First launch — getting components ready
On first launch Gradient downloads three helper components: a converter (ffmpeg), a browser engine (Chromium) and a diagram editor (draw.io). A progress bar shows; if something fails choose Retry, and when it's done review the licence notices and choose Continue. The app opens once everything is ready.
Later you can check or re-download them in Settings → Components. More in Getting started.
Sign in
Files, search and viewing work without signing in, even offline. AI answers, image generation and teams need your account. Sign in from Settings → Account: the system browser opens, and when it finishes it asks to open Gradient — choose Open to come back to the app.
See your plan and this week's usage in the app under Settings › Account › Usage, or on this site's Account page.
Updates
Settings → About · Updates shows your version, checks for a new one, installs it and restarts. A dot appears on the list item when a new version is out. Nothing is forced. Downloaded installers are installed only after their signature checks out against the key built into the app.
If you get stuck
Start with Troubleshooting; if that doesn't help, send it from Settings → Contact in the app.