Reading the repo

Opening the box…

How to install cherry-studio on Linux (CherryHQ/cherry-studio) · gitmanual

How to install on Linux

CherryHQ/cherry-studio

Your AI workspace for models, agents, and productivity.

Node.jsVite#agent-skills#agent-workspace#agentic-workspace#ai-agents

Difficulty: Moderate
Time: about 15 min
Stars: ★ 53,298
Activity: Updated this month
License: AGPL-3.0
Open issues: 2,538
Got it running: Be the first
Looked up: 13 h ago

GitHub didn't answer, so this is the saved copy from 13 h ago

Start here

Website ↗cherryai.comThe project's own site.Docs ↗cherryai.comLinked from the README.

Will it work on my device?

Yes, it installs on your Linux

A ready-made Linux download is in the latest release.

Checking for

macOS Windows Linux

Download for Linux

v2.1.10 · 10/31/2026 ↗

Cherry-Studio-2.1.10-linux-x64.AppImage

AppImage · x64 · 312.0 MB · 2,171 downloads · best match

Download

curl -LO "https://github.com/CherryHQ/cherry-studio/releases/download/v2.1.10/Cherry-Studio-2.1.10-linux-x64.AppImage"
chmod +x "Cherry-Studio-2.1.10-linux-x64.AppImage"
./"Cherry-Studio-2.1.10-linux-x64.AppImage"

Other Linux downloads (5)

Cherry-Studio-2.1.10-linux-x64.deb

deb · x64 · 257.8 MB · 1,460 downloads

Download

curl -LO "https://github.com/CherryHQ/cherry-studio/releases/download/v2.1.10/Cherry-Studio-2.1.10-linux-x64.deb"
sudo apt install ./"Cherry-Studio-2.1.10-linux-x64.deb"

Cherry-Studio-2.1.10-linux-arm64.AppImage

AppImage · ARM64 · 311.4 MB · 311 downloads

Download

curl -LO "https://github.com/CherryHQ/cherry-studio/releases/download/v2.1.10/Cherry-Studio-2.1.10-linux-arm64.AppImage"
chmod +x "Cherry-Studio-2.1.10-linux-arm64.AppImage"
./"Cherry-Studio-2.1.10-linux-arm64.AppImage"

Cherry-Studio-2.1.10-linux-arm64.deb

deb · ARM64 · 246.6 MB · 320 downloads

Download

curl -LO "https://github.com/CherryHQ/cherry-studio/releases/download/v2.1.10/Cherry-Studio-2.1.10-linux-arm64.deb"
sudo apt install ./"Cherry-Studio-2.1.10-linux-arm64.deb"

Cherry-Studio-2.1.10-linux-x64.rpm

rpm · x64 · 222.4 MB · 443 downloads

Download

curl -LO "https://github.com/CherryHQ/cherry-studio/releases/download/v2.1.10/Cherry-Studio-2.1.10-linux-x64.rpm"
sudo dnf install ./"Cherry-Studio-2.1.10-linux-x64.rpm"

Cherry-Studio-2.1.10-linux-arm64.rpm

rpm · ARM64 · 211.7 MB · 175 downloads

Download

curl -LO "https://github.com/CherryHQ/cherry-studio/releases/download/v2.1.10/Cherry-Studio-2.1.10-linux-arm64.rpm"
sudo dnf install ./"Cherry-Studio-2.1.10-linux-arm64.rpm"

Did you get it running?

No reports for Linux yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for Linux. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 24.18.1runtime
1×pnpm pnpm@12.6.0package manager

7× settings in .env

NODE_OPTIONS
API_KEYsecret
BASE_URL
MODEL
CSLOGGER_MAIN_LEVEL
CSLOGGER_RENDERER_LEVEL
MAIN_VITE_CHERRY_CLOUD_API_ORIGIN

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/CherryHQ/cherry-studio/badge.svg)](https://gitmanual.com/CherryHQ/cherry-studio)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: native/system-speech/package.json, packages/agent-behavior/package.json, packages/agent-runtime-claude-code/package.json, packages/agent-runtime-pi-durable/package.json and 11 more

package.json scripts (131)

agent-notes:check-transitiontsx scripts/docsGovernance/verify-agent-note-transitions.ts
analyze:mainVISUALIZER_MAIN=true pnpm build
analyze:rendererVISUALIZER_RENDERER=true pnpm build
benchvitest bench --run
bench:aicorevitest bench --run --project "aiCore (bench)"
bench:mainvitest bench --run --project "main (bench)"
bench:renderervitest bench --run --project "renderer (bench)"
bench:sharedvitest bench --run --project "shared (bench)"
buildpnpm run typecheck && dotenv -v CHERRY_EDITION=global -- electron-vite build && pnpm run build:utility-process
build:builtin-knowledgetsx scripts/generate-cherry-assistant-knowledge
build:builtin-knowledge:checktsx scripts/generate-cherry-assistant-knowledge --check
build:checkpnpm check:all
build:cnpnpm run typecheck && dotenv -v CHERRY_EDITION=cn -- electron-vite build && pnpm run build:utility-process
build:linuxdotenv pnpm run build && electron-builder --linux --x64 --arm64
build:linux:arm64dotenv pnpm run build && electron-builder --linux --arm64
build:linux:arm64:cnpnpm run build:cn && electron-builder --config electron-builder.cn.config.cjs --linux --arm64
build:linux:cnpnpm run build:cn && electron-builder --config electron-builder.cn.config.cjs --linux --x64 --arm64
build:linux:x64dotenv pnpm run build && electron-builder --linux --x64
build:linux:x64:cnpnpm run build:cn && electron-builder --config electron-builder.cn.config.cjs --linux --x64
build:macdotenv pnpm run build && electron-builder --mac --arm64 --x64
build:mac:arm64dotenv pnpm run build && electron-builder --mac --arm64
build:mac:arm64:cnpnpm run build:cn && electron-builder --config electron-builder.cn.config.cjs --mac --arm64
build:mac:cnpnpm run build:cn && electron-builder --config electron-builder.cn.config.cjs --mac --arm64 --x64
build:mac:x64dotenv pnpm run build && electron-builder --mac --x64
build:mac:x64:cnpnpm run build:cn && electron-builder --config electron-builder.cn.config.cjs --mac --x64

Files we read (13)

.env.example

.github/workflows/auto-release-build.yml

.github/workflows/ci-metrics.yml

.github/workflows/ci-rerun-on-base-change.yml

.github/workflows/ci.yml

.github/workflows/e2e-regression-test.yml

.github/workflows/nightly-build.yml

.node-version

.nvmrc

CONTRIBUTING.md

README.md

package.json

pnpm-workspace.yaml

Branch main · 12,643 files in the repo