如何安装 cherry-studio — Agent工作流安装教程

⚙️

Agent工作流

cherry-studio

本页面提供 cherry-studio 的完整安装教程，包含系统要求、分步骤安装说明、验证命令和常见安装问题排查。

🖥️ 安装前准备 — 系统要求

组件	版本要求	说明
Node.js	v18+	推荐使用 LTS 版本
npm 或 pnpm	最新版
Git	2.0+	用于克隆项目仓库

⚙️ 分步安装指南

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：npm 全局安装
npm install -g cherry-studio

# 方式二：npx 直接运行（无需安装）
npx cherry-studio --help

# 方式三：项目依赖安装
npm install cherry-studio

# 方式四：从源码运行
git clone https://github.com/CherryHQ/cherry-studio
cd cherry-studio
npm install
npm start

📋 详细安装步骤

访问 GitHub 仓库获取工作流文件
在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
上传工作流文件
按照提示配置必要的环境变量和 API Key
运行测试确认流程正常后投入使用

✅ 验证安装是否成功

完成安装后，运行以下命令确认一切正常：

验证命令

# 验证 Node.js 环境
node --version

# 验证工具是否安装成功
cherry-studio --version

🔧 常见安装问题解答

`pip install` 速度太慢，有加速方案吗？−

使用国内镜像源：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ <package>。或配置全局默认源：pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/。也可以考虑使用 uv（速度更快的 Python 包管理器）：uv pip install <package>。

如何在虚拟环境中安装，避免污染系统环境？+

遇到 Permission Denied 错误，如何处理？+

怎么确认工具安装成功？+

✅ 安装完成？接下来学习如何使用

查看 cherry-studio 使用教程，包含快速上手、实战场景和进阶技巧

📚 使用教程 → ← 工具详情

🔗 原始来源

🐙 GitHub 仓库 https://github.com/CherryHQ/cherry-studio 🌐 官方网站 https://cherry-ai.com

AI Skill Hub 安装教程页 · 基于公开数据整理，实际安装请以官方文档为准。License：AGPL-3.0