OpenRouter
You need an API key from the provider.
~/AppData/Roaming/CherryStudio/config.json
Get a key ↗Cherry Studio
A polished desktop AI workspace that connects to many model providers
WindowsmacOS Difficulty ●○○○○ stable v2.2.0
Cherry Studio · icon from the registry
System requirements
No extra runtime needed
This app ships with everything it needs — no Node.js, Python or other runtimes to install.
Platforms
WindowsmacOS
A polished desktop AI workspace that connects to many model providers
Registry data updated: 2026-11-11
Config & data
Config file written to
~/AppData/Roaming/CherryStudio/config.json
- ~/AppData/Roaming/CherryStudio
- ~/Library/Application Support/CherryStudio
Everything stays on your own machine — nothing is uploaded. To uninstall, delete these folders.
Install in three steps
- 01
Install AiBOX
One portable file for Windows (macOS coming). Double-click and it runs — no installer, no administrator rights.
Go to download → - 02
Pick Cherry Studio
Open the AiBOX app catalog, find Cherry Studio and press Install. AiBOX checks what your machine already has and installs only what is missing.
- 03
Follow the wizard
It downloads with a checksum check, writes the config and fills in your API key if the app needs one. You just click.
✓ Installed until it works.
Prefer to do it by hand? The full written guide is right below. Read the guide ↓
Install guide
The same steps in written form — follow along at your own pace.
The full pictorial tutorial lives on the aibox.im /apps/cherry-studio/ page (generated from this repo). Tagline: "Installed until it works."
1. Health check (automatic)
AiBOX checks your machine first. Cherry Studio is self-contained — no Node.js required.
2. Route selection (automatic)
- International network: official GitHub Releases (direct).
- Mainland China: ghfast / gh-proxy gateway channels, automatic fallback.
3. Install (one click)
Download with SHA256 verification, then silent install (Windows x64/ARM64: NSIS to %LOCALAPPDATA%\Programs\Cherry Studio; macOS: Intel / Apple Silicon dmg copied to /Applications). No admin rights.
4. Add your key (the only step you do)
Pick a provider: OpenRouter (recommended) / Anthropic / OpenAI / Google. Paste the key in Cherry Studio's provider settings and you are ready to chat.
5. Verify (automatic)
We check the installed version — "Installed. It really works."
Model / API key setup
AiBOX fills this in for you during the wizard — this section is for setting it up by hand.
Anthropic (Claude)
You need an API key from the provider.
~/AppData/Roaming/CherryStudio/config.json
Get a key ↗OpenAI
You need an API key from the provider.
~/AppData/Roaming/CherryStudio/config.json
Get a key ↗Google AI Studio
You need an API key from the provider.
~/AppData/Roaming/CherryStudio/config.json
Get a key ↗Common questions
- Which platforms does Cherry Studio run on?
-
Runs on Windows / macOS — install it with AiBOX on any of them.
- How hard is Cherry Studio to install?
-
Difficulty 1 out of 5. AiBOX does the download and setup; your part is clicking through the wizard and pasting a key if the app needs one.
- Where does Cherry Studio keep my data?
-
Everything stays on your own machine: ~/AppData/Roaming/CherryStudio / ~/Library/Application Support/CherryStudio. To uninstall, delete these — nothing is ever uploaded.
- Something not working?
-
An outdated step, an error you do not understand, a typo — tell us and we will fix this page.
Version & updates
- Current version
- v2.2.0
- Registry data updated
- 2026-11-11
Upstream projects
Version numbers are re-checked by our daily probe — when upstream ships a new release, this page follows.
Questions or problems?
A wrong step, a confusing error, a typo — open an issue and someone will look.