mrkeyoor.com_
Mon 02 Nov 01:12 UTC
AI Toolsevaluationupdated 30 Sept 2026

cherry-studio review

Cherry Studio is a desktop client for using cloud and local language models on Windows, macOS, and Linux. It brings provider switching, side-by-side model conversations, assistants, document work, WebDAV backup, and MCP tools into one graphical app.

+160stars / 7d
Verdict

Our Cherry Studio run installed 2,775 packages and occupied 3,783 MB, then commit fd1a69d failed its build and ran past the 900-second test cap. Use the packaged desktop release if you want one personal workspace for cloud models, local models, documents, agents, and MCP tools. Do not base a downstream release on this source commit until its missing module errors and unfinished suite are resolved in your own build environment.

We ran it

Lab card: what happened when we ran cherry-studioScreenshot of cherry-studio (cherryai.com)
Install✓ · 173s2775 packages · 3783 MB
Build✗ · 87s
Tests✗ timed out · 900sran, no count parsed
Repo9633 files~1,482,173 lines of source · 94 MB · 23 CI workflows · tests dir

Answers from our run

Does cherry-studio build from source?

Dependencies installed in 173 seconds (2775 packages), and the build failed. We cloned commit fd1a69d into a clean Debian container with 3 CPUs and no project-specific setup.

Do cherry-studio's tests pass?

We could not finish them: the suite was still running after 15 minutes in our container.

Who should not use cherry-studio?

Contributors who require a clean fresh-container gate: commit fd1a69d failed its build, and its tests exceeded our 900-second cap.

What are the alternatives to cherry-studio?

Jan, Open WebUI, AnythingLLM. Our Cherry Studio run installed 2,775 packages and occupied 3,783 MB, then commit fd1a69d failed its build and ran past the 900-second test cap.

Setup2/53,783 MB install, failed build, and tests exceeded 900 seconds
Docs4/5Clear downloads, development steps, editions, and license terms
Community5/552,269 stars with a September 30 push and same-day issue work
Maturity3/5v2.1.3 ships broadly, but our source checks did not pass

Discussed on

  1. hnLLM desktop client – Cherry Studio3 points

Who it’s for

Desktop users who regularly switch between hosted model providers.
Ollama and LM Studio users who want local models in the same app as cloud models.
People who work with PDFs, Office files, images, translation, and saved chat topics.
Agent and MCP users who are comfortable deciding which tools may access their files and prompts.

Who it’s NOT for

Contributors who require a clean fresh-container gate: commit fd1a69d failed its build, and its tests exceeded our 900-second cap.
Small developer machines: our pnpm install pulled 2,775 packages and occupied 3,783 MB.
Teams expecting central accounts, model policy, shared knowledge bases, and role controls in the community app: the README assigns those functions to the enterprise edition.
Mobile-first users: the README still lists the Android and iOS apps as Phase 1 roadmap work.
Organizations unwilling to follow AGPL-3.0 or arrange the separate commercial license offered by CherryHQ.

Setup reality

Our fresh Debian sandbox installed commit fd1a69d in 173 seconds, adding 2,775 packages and using 3,783 MB. The build failed after 87 seconds because the node typecheck could not resolve Cherry Studio remote-protocol and remote-transport modules. Tests timed out after 900 seconds without a final suite result.

Packaged releases need no development environment. Cloud services still need their own accounts and credentials, while local use depends on Ollama or LM Studio. Source contributors need the repository's pinned Node and pnpm versions, must copy .env.example, and then run the workspace through pnpm.

Release v2.1.3 provides x64 and arm64 downloads for Windows, macOS, and Linux. Windows contributors must enable symlinks before cloning. Our scan found 23 CI workflow files and a tests directory, but no Dockerfile, so the repository does not provide a matching container path for the 3-CPU, 8 GB sandbox we used.

One desktop joins cloud and local models

Cherry Studio gives Windows, macOS, and Linux users one interface for OpenAI, Gemini, Anthropic, other web services, Ollama, and LM Studio. You can create assistants, keep topics, translate text, search across the app, and compare multiple models in the same conversation. That bundle makes sense when your current AI setup is a row of provider tabs beside a separate local-model client.

The README claims more than 300 preconfigured assistants and accepts text, images, Office files, and PDFs. WebDAV handles file management and backup, while Mermaid rendering and code highlighting keep technical answers readable. Convenience does not merge the privacy boundaries. A prompt sent to Ollama stays on a different path from one sent to a cloud account, even when both conversations sit in the same window.

Packaged v2.1.3 downloads avoid the source toolchain

Release v2.1.3 includes x64 and arm64 builds for Windows, macOS, and Linux. Windows gets installers and portable executables, macOS gets DMG and ZIP files, and Linux gets AppImage, DEB, and RPM packages. That is the route implied by the README's claim that ordinary users need no environment setup. It is also the sensible first trial for someone evaluating the application rather than changing its code.

Source work is a different proposition. The measured checkout contained 9,633 files, about 1,482,173 lines of source, and occupied 94 MB before installation. It is a pnpm workspace with 23 CI workflow files and a tests directory. The developer guide asks contributors to use the pinned Node and pnpm versions, copy .env.example, and start Electron through pnpm. Windows developers must enable symlinks before cloning.

What happened when we ran it

Our sandbox installed commit fd1a69d in 173 seconds. Pnpm added 2,775 packages and brought disk use to 3,783 MB inside a fresh Debian container with 3 CPUs, 8 GB of RAM, Node 22, no secrets, and no elevated privileges. Installation succeeded. Those figures describe repository setup only. We did not measure chat latency, model quality, document accuracy, or the packaged application's memory use.

The build failed after 87 seconds with exit code 1. The node typecheck could not find @cherrystudio/remote-protocol/agent, @cherrystudio/remote-protocol/failure, the package root for that protocol, and @cherrystudio/remote-transport. The errors appeared in remote access services, shared AI code, data types, and IPC schemas. The log does not identify why those modules were unavailable, so a missing package, build-order problem, or system dependency would be speculation.

Tests continued until the 900-second limit and then timed out. The tail shows several ModelService reconciliation cases passing, including cases for custom Ollama, OpenAI, and ComfyUI models. It also shows chunks large removal filters and deletes failing while the wider suite was still running. There is no final test count in the supplied log, which means those passing lines cannot be turned into a pass rate or a near-success claim.

Remote access in v2.1.3 still leaves mobile apps on the roadmap

The v2.1.3 notes add encrypted LAN pairing with a compatible mobile client, letting that client import providers and use desktop agents. They also warn that legacy devices must pair again under the new identity protocol. This is useful remote access, especially if the desktop already holds the model setup, but it does not make Cherry Studio a standalone mobile app.

Android and iOS remain Phase 1 entries in the README roadmap. The same roadmap lists an MCP marketplace, OCR, text-to-speech, notes, a plugin system, and multi-window support. Treat those entries as direction, not as present-day buying reasons. The features you can count on are the ones documented in the current desktop release, including its MCP server, assistants, file support, search, translation, and local-model connections.

AGPL-3.0 and edition limits matter for company use

The community edition uses AGPL-3.0, and CherryHQ says commercial use is allowed when you comply with that license. The project also offers a separate commercial license for organizations that need an exemption. That choice deserves review before a company modifies or redistributes the client. A public repository and a commercial deployment can coexist, but the license terms still set the conditions.

The edition table draws another boundary. Central model management, employee accounts, role-based access, shared knowledge bases, and managed backup belong to the enterprise product. The community edition's server row is empty. Version 2.1.3 is therefore a broad personal desktop client, while the team control plane described by CherryHQ is a separately sold product with a private deployment path.

September 30 activity shows maintenance, with a large queue

GitHub recorded 52,269 stars, 1,682 open issues and pull requests combined, and a last push on September 30, 2026. Release v2.1.3 had shipped six days earlier. The 1,682 figure mixes issues and pull requests, and it shows the review load around a very large project. On September 30, maintainers closed issue 21208 about a startup race in device connection setup, while issue 21209 reported a new sidebar hover loop.

The current release, same-day push, and same-day issue movement point to active maintenance. They do not cancel our source result at commit fd1a69d: 3,783 MB of installed files, a failed 87-second build, and no complete test result after 900 seconds. Try the packaged app if its provider breadth saves you daily friction. Contributors and downstream packagers should demand a green run on the exact revision they plan to ship.

Alternatives

ProjectWhat it isPick it when
Jan gh↗A local-first desktop AI client built around offline use and optional cloud connections.pick this instead when running models on your own computer is the main requirement.
Open WebUI gh↗A self-hosted browser interface for Ollama and OpenAI-compatible backends.pick this instead when several users should share one server through a browser.
AnythingLLM gh↗A local-first desktop and server workspace centered on documents and agents.pick this instead when document collections and team workspaces matter more than model comparison.

Sources

  1. Cherry Studio repository and README
  2. Cherry Studio v2.1.3 release
  3. Cherry Studio development guide
  4. Cherry Studio contributor guide
  5. Device connection startup race task
  6. Sidebar hover loop report
  7. Cherry Studio measured commit

More ai tools reviews

kornia · skills · anarlog · pr-agent · agent-sprite-forge · KiroCrew · the whole board →