Cherry Studio App - 开源移动 AI 客户端

Cherry Studio App 是 Cherry Studio 的官方移动版本，将强大的 LLMs (AI 大语言模型) 交互带到您的 iOS 和 Android 设备。该项目基于 React Native 和 Expo 构建，支持多 LLM 提供商，提供流畅的移动 AI 对话体验。

项目简介

Cherry Studio App 是由 CherryHQ 团队开发维护的开源项目，是桌面版 Cherry Studio 的移动延伸。截至目前，该项目在 GitHub 上已获得 2.7k+ stars，拥有 187 个 forks，是一个活跃的开源社区项目。

该项目采用 AGPL-3.0 开源协议，允许开发者自由使用、修改和分发。

核心特性

• 多 LLM 提供商支持：逐步集成 OpenAI、Gemini、Anthropic 等主流 AI 提供商
• AI 助手 & 对话：访问预设助手，进行流畅的多模型对话
• 移动优化：专为 iOS/Android 设计，支持浅色/深色主题切换
• 核心工具：会话管理、历史搜索、数据迁移等功能
• MCP 支持：支持 StreamableHTTP MCP 协议
• 文件支持：支持 PDF、Markdown 等文件格式处理
• 图片粘贴：支持在文本输入框中粘贴图片

技术栈

安装指南

前置要求

• Node.js >= 18
• pnpm >= 8（推荐）
• iOS: Xcode（Mac）或物理设备
• Android: Android Studio 和 SDK

安装步骤

# 克隆仓库
git clone https://github.com/CherryHQ/cherry-studio-app.git

# 进入目录
cd cherry-studio-app

# 安装依赖
pnpm install

# 生成数据库
npx drizzle-kit generate

# 构建 MCP Streamable Http
cd packages/react-native-streamable-http
npm install
npm run build

启动应用程序

iOS

npx expo prebuild -p ios
cd ios
# 添加自签证书
npx expo run:ios -d

Android

npx expo prebuild -p android
cd android
# 在 local.properties 中添加 Android SDK 路径
npx expo run:android -d

Android SDK 设置

Windows 用户:

Mac 用户:

Linux (Ubuntu) 用户:

⚠️ 请使用实体设备或模拟器进行开发，请勿使用 Expo Go

项目结构

cherry-studio-app/
├── src/                    # 源代码
├── modules/                # 原生模块
├── packages/               # 子包（如 react-native-streamable-http）
├── db/                     # 数据库相关
├── docs/                   # 文档
├── drizzle/                # Drizzle ORM 配置
├── scripts/                # 构建脚本
├── plugins/                # 插件
└── patches/                # 补丁文件

开发文档

项目的详细开发文档位于 docs 文件夹中，包括：

• 架构设计说明
• API 文档
• 贡献指南
• 发布流程

社区与贡献

• GitHub 仓库: https://github.com/CherryHQ/cherry-studio-app
• Issues: 89 个开放问题
• Pull Requests: 18 个待合并
• 提交历史: 1,723+ commits

赞助支持

如果您喜欢这个项目，可以通过以下方式支持：

• 给仓库点个 Star ⭐
• 成为赞助商

相关项目

• Cherry Studio 桌面版 - 功能强大的桌面端 LLM 客户端

许可证

本项目采用 GNU AGPL-3.0 开源许可证。