🍒 Cherry Studio is a desktop client that supports for multiple LLM providers.
Go to file
Phantom da96459bff
feat(ProviderSettings): add more api options for non-system providers (#7794)
* feat(ProviderSettings): Move compatibility mode settings to AddProviderPopup

* feat(provider): 添加兼容性提示工具组件

为不支持数组格式用户消息的API添加兼容性提示工具组件,并在多语言文件中新增相关翻译

* refactor(ProviderSetting): 重构提供商兼容模式设置,将选项移至设置页面并添加提示

移除添加提供商弹窗中的兼容模式选项,将其移至提供商设置页面
为兼容模式添加提示说明,优化用户体验

* docs(i18n): 为多语言文件添加misc翻译项

* refactor(组件): 移除InfoTooltip组件并直接使用Tooltip

* chore(scripts): 优化翻译提示词

* feat(i18n): 为兼容模式添加多语言标签和提示信息

为不支持数组格式用户消息的API添加兼容模式的多语言标签和提示信息,并更新相关组件引用

* feat(provider): 添加对stream_options和developer_role的支持

- 在Provider类型中新增isSupportStreamOptions和isSupportDeveloperRole字段
- 新增ApiOptionsSettings组件用于配置API选项
- 实现stream_options和developer_role的开关功能
- 添加相关i18n翻译

* feat(provider): 添加对数组格式 message content 的支持

- 新增数组内容支持配置项及国际化文案
- 重构 provider 类型定义,将支持属性改为不支持属性
- 添加数组内容支持判断逻辑
- 更新迁移逻辑以处理新字段

* refactor(provider): 优化API选项设置界面和类型定义

重构API选项设置组件,使用InfoTooltip显示帮助信息
调整i18n文案结构,分离标签和帮助文本
添加过渡效果更新provider状态

* fix(providers): 修复提供者功能支持判断逻辑

修改提供者功能支持判断逻辑,优先检查提供者的特定属性

* refactor(openai): 调整导入语句顺序并移除重复导入

* fix(ProviderSettings): 当options为空时返回null避免渲染错误

* fix(ProviderSettings): 当provider为系统时隐藏API选项设置

当provider标记为系统时,不应显示API选项设置,避免用户误操作

* fix(迁移): 修复内置提供商迁移逻辑并更新API选项设置

迁移旧配置时,修正内置提供商的识别逻辑,确保已删除的内置提供商标记正确
同时更新所有提供商的API选项设置

* refactor(provider): 重构系统提供商判断逻辑

使用 INITIAL_PROVIDERS 列表来判断系统提供商,替代直接使用 isSystem 字段
添加 SystemProvider 类型并更新相关类型定义
修复多处使用 isSystem 字段的判断逻辑

* refactor(store): 重命名INITIAL_PROVIDERS为SYSTEM_PROVIDERS以更准确描述用途

* feat(i18n): 添加i18n

* refactor(ProviderSettings): 移除SYSTEM_PROVIDERS依赖并简化菜单逻辑

处理遗留的系统提供商数据,不再依赖已删除的SYSTEM_PROVIDERS常量

* fix(ProviderSettings): 修复提供商头像显示逻辑,优先使用获取到的logo

当获取到提供商logo时直接显示,不再检查是否为系统提供商
2025-08-03 23:51:33 +08:00
.github Chore/issue template (#8789) 2025-08-03 12:51:37 +08:00
.husky chore(pre-commit): add pre-commit hook to enforce code style (#3351) 2025-03-15 11:09:11 +08:00
.vscode fix(i18n): standardize i18n usage (#8525) 2025-07-25 22:03:31 +08:00
.yarn chore(deps): update vite to rolldown-vite (#8460) 2025-07-25 00:55:07 +08:00
build feat(installer): add architecture compatibility check to NSIS installer (#8587) 2025-07-28 21:41:05 +08:00
docs docs: update how to i18n demo pic 2025-07-31 17:39:58 +08:00
packages fix: flush redux persist data when app quit and update (#8741) 2025-08-01 14:47:11 +08:00
resources refactor: remove agents.json file 2025-08-01 11:11:43 +08:00
scripts feat(ProviderSettings): add more api options for non-system providers (#7794) 2025-08-03 23:51:33 +08:00
src feat(ProviderSettings): add more api options for non-system providers (#7794) 2025-08-03 23:51:33 +08:00
tests refactor: Unified Logger / 统一日志管理 (#8207) 2025-07-18 09:40:56 +08:00
.editorconfig style: set eol to lf, code formatting (#7923) 2025-07-08 09:50:33 +08:00
.env.example chore(env): add .env.example file and update .gitignore 2025-07-24 15:02:03 +08:00
.git-blame-ignore-revs chore: git blame ignore (#7925) 2025-07-08 14:23:55 +08:00
.gitattributes style: set eol to lf, code formatting (#7923) 2025-07-08 09:50:33 +08:00
.gitignore chore: ignore qwen-code settings (#8509) 2025-07-25 12:20:20 +08:00
.npmrc opt: optimise local dev with fixed yarn (#3456) 2025-03-19 13:18:11 +08:00
.prettierignore feat: nutstore integration (#3461) 2025-03-25 11:40:11 +08:00
.prettierrc chore(i18n): Separate check-i18n and sync-i18n; add auto sort i18n (#8206) 2025-07-19 23:26:40 +08:00
.yarnrc.yml chore: upgrade yarn version to v4.9.1 2025-05-22 15:48:20 +08:00
AGENT.md feat: Support Cherry Studio as a Service (CSaaS) (#8098) 2025-07-30 12:38:07 +08:00
CLAUDE.md docs: update CLAUDE.md with current project requirements (#8729) 2025-08-01 00:26:56 +08:00
CODE_OF_CONDUCT.md docs: update documentation for a more inclusive environment and added japanese and chinese documentation 2024-10-25 00:09:01 +08:00
CONTRIBUTING.md docs: add testplan md (#7854) 2025-07-05 17:19:25 +08:00
dev-app-update.yml feat: add after-build script for renaming files and updating latest.yml 2025-04-14 17:14:45 +08:00
electron-builder.yml refactor: remove mac ocr 2025-07-31 21:51:16 +08:00
electron.vite.config.ts refactor: remove mac ocr 2025-07-31 21:51:16 +08:00
eslint.config.mjs fix: set consolelog eslint to error when in prci lint check (#8532) 2025-07-26 09:21:18 +08:00
LICENSE Update LICENSE (#4744) 2025-04-13 08:00:41 +08:00
package.json perf: model select popup (#8766) 2025-08-02 23:17:14 +08:00
playwright.config.ts test: more unit tests (#5130) 2025-05-26 16:50:26 +08:00
README.md refactor: match provider and model using a consistent method (#7933) 2025-07-23 10:45:09 +08:00
SECURITY.md refactor: model list and health check (#7997) 2025-07-21 15:57:08 +08:00
tsconfig.json feat: Support LLM Tracing by Alibaba Cloud EDAS product (#7895) 2025-07-20 14:53:35 +08:00
tsconfig.node.json chore(tsconfig): adjust the path order (#8769) 2025-08-02 00:05:15 +08:00
tsconfig.web.json chore(tsconfig): adjust the path order (#8769) 2025-08-02 00:05:15 +08:00
vitest.config.ts refactor(Knowledge): simplify dimension settings, support base migration (#8315) 2025-07-26 10:54:06 +08:00
yarn.lock perf: model select popup (#8766) 2025-08-02 23:17:14 +08:00

banner

English | 中文 | Official Site | Documents | Development | Feedback

Featured|HelloGitHub kangfenmao%2Fcherry-studio | Trendshift Cherry Studio - AI Chatbots, AI Desktop Client | Product Hunt

🍒 Cherry Studio

Cherry Studio is a desktop client that supports multiple LLM providers, available on Windows, Mac and Linux.

👏 Join Telegram GroupDiscord | QQ Group(575014769)

❤️ Like Cherry Studio? Give it a star 🌟 or Sponsor to support the development!

🌠 Screenshot

🌟 Key Features

  1. Diverse LLM Provider Support:
  • ☁️ Major LLM Cloud Services: OpenAI, Gemini, Anthropic, and more
  • 🔗 AI Web Service Integration: Claude, Peplexity, Poe, and others
  • 💻 Local Model Support with Ollama, LM Studio
  1. AI Assistants & Conversations:
  • 📚 300+ Pre-configured AI Assistants
  • 🤖 Custom Assistant Creation
  • 💬 Multi-model Simultaneous Conversations
  1. Document & Data Processing:
  • 📄 Supports Text, Images, Office, PDF, and more
  • ☁️ WebDAV File Management and Backup
  • 📊 Mermaid Chart Visualization
  • 💻 Code Syntax Highlighting
  1. Practical Tools Integration:
  • 🔍 Global Search Functionality
  • 📝 Topic Management System
  • 🔤 AI-powered Translation
  • 🎯 Drag-and-drop Sorting
  • 🔌 Mini Program Support
  • ⚙️ MCP(Model Context Protocol) Server
  1. Enhanced User Experience:
  • 🖥️ Cross-platform Support for Windows, Mac, and Linux
  • 📦 Ready to Use - No Environment Setup Required
  • 🎨 Light/Dark Themes and Transparent Window
  • 📝 Complete Markdown Rendering
  • 🤲 Easy Content Sharing

📝 Roadmap

We're actively working on the following features and improvements:

  1. 🎯 Core Features
  • Selection Assistant with smart content selection enhancement
  • Deep Research with advanced research capabilities
  • Memory System with global context awareness
  • Document Preprocessing with improved document handling
  • MCP Marketplace for Model Context Protocol ecosystem
  1. 🗂 Knowledge Management
  • Notes and Collections
  • Dynamic Canvas visualization
  • OCR capabilities
  • TTS (Text-to-Speech) support
  1. 📱 Platform Support
  • HarmonyOS Edition (PC)
  • Android App (Phase 1)
  • iOS App (Phase 1)
  • Multi-Window support
  • Window Pinning functionality
  1. 🔌 Advanced Features
  • Plugin System
  • ASR (Automatic Speech Recognition)
  • Assistant and Topic Interaction Refactoring

Track our progress and contribute on our project board.

Want to influence our roadmap? Join our GitHub Discussions to share your ideas and feedback!

🌈 Theme

Welcome PR for more themes

🤝 Contributing

We welcome contributions to Cherry Studio! Here are some ways you can contribute:

  1. Contribute Code: Develop new features or optimize existing code.
  2. Fix Bugs: Submit fixes for any bugs you find.
  3. Maintain Issues: Help manage GitHub issues.
  4. Product Design: Participate in design discussions.
  5. Write Documentation: Improve user manuals and guides.
  6. Community Engagement: Join discussions and help users.
  7. Promote Usage: Spread the word about Cherry Studio.

Refer to the Branching Strategy for contribution guidelines

Getting Started

  1. Fork the Repository: Fork and clone it to your local machine.
  2. Create a Branch: For your changes.
  3. Submit Changes: Commit and push your changes.
  4. Open a Pull Request: Describe your changes and reasons.

For more detailed guidelines, please refer to our Contributing Guide.

Thank you for your support and contributions!

🔧 Developer Co-creation Program

We are launching the Cherry Studio Developer Co-creation Program to foster a healthy and positive-feedback loop within the open-source ecosystem. We believe that great software is built collaboratively, and every merged pull request breathes new life into the project.

We sincerely invite you to join our ranks of contributors and shape the future of Cherry Studio with us.

Contributor Rewards Program

To give back to our core contributors and create a virtuous cycle, we have established the following long-term incentive plan.

The inaugural tracking period for this program will be Q3 2025 (July, August, September). Rewards for this cycle will be distributed on October 1st.

Within any tracking period (e.g., July 1st to September 30th for the first cycle), any developer who contributes more than 30 meaningful commits to any of Cherry Studio's open-source projects on GitHub will be eligible for the following benefits:

  • Cursor Subscription Sponsorship: Receive a $70 USD credit or reimbursement for your Cursor subscription, making AI your most efficient coding partner.
  • Unlimited Model Access: Get unlimited API calls for the DeepSeek and Qwen models.
  • Cutting-Edge Tech Access: Enjoy occasional perks, including API access to models like Claude, Gemini, and OpenAI, keeping you at the forefront of technology.

Growing Together & Future Plans

A vibrant community is the driving force behind any sustainable open-source project. As Cherry Studio grows, so will our rewards program. We are committed to continuously aligning our benefits with the best-in-class tools and resources in the industry. This ensures our core contributors receive meaningful support, creating a positive cycle where developers, the community, and the project grow together.

Moving forward, the project will also embrace an increasingly open stance to give back to the entire open-source community.

How to Get Started?

We look forward to your first Pull Request!

You can start by exploring our repositories, picking up a good first issue, or proposing your own enhancements. Every commit is a testament to the spirit of open source.

Thank you for your interest and contributions.

Let's build together.

🏢 Enterprise Edition

Building on the Community Edition, we are proud to introduce Cherry Studio Enterprise Edition—a privately-deployable AI productivity and management platform designed for modern teams and enterprises.

The Enterprise Edition addresses core challenges in team collaboration by centralizing the management of AI resources, knowledge, and data. It empowers organizations to enhance efficiency, foster innovation, and ensure compliance, all while maintaining 100% control over their data in a secure environment.

Core Advantages

  • Unified Model Management: Centrally integrate and manage various cloud-based LLMs (e.g., OpenAI, Anthropic, Google Gemini) and locally deployed private models. Employees can use them out-of-the-box without individual configuration.
  • Enterprise-Grade Knowledge Base: Build, manage, and share team-wide knowledge bases. Ensures knowledge retention and consistency, enabling team members to interact with AI based on unified and accurate information.
  • Fine-Grained Access Control: Easily manage employee accounts and assign role-based permissions for different models, knowledge bases, and features through a unified admin backend.
  • Fully Private Deployment: Deploy the entire backend service on your on-premises servers or private cloud, ensuring your data remains 100% private and under your control to meet the strictest security and compliance standards.
  • Reliable Backend Services: Provides stable API services and enterprise-grade data backup and recovery mechanisms to ensure business continuity.

Online Demo

🚧 Public Beta Notice

The Enterprise Edition is currently in its early public beta stage, and we are actively iterating and optimizing its features. We are aware that it may not be perfectly stable yet. If you encounter any issues or have valuable suggestions during your trial, we would be very grateful if you could contact us via email to provide feedback.

🔗 Cherry Studio Enterprise

Version Comparison

Feature Community Edition Enterprise Edition
Open Source Yes Partially released to customers
Cost Free for Personal Use / Commercial License Buyout / Subscription Fee
Admin Backend ● Centralized Model Access
Employee Management
● Shared Knowledge Base
Access Control
Data Backup
Server Dedicated Private Deployment

Get the Enterprise Edition

We believe the Enterprise Edition will become your team's AI productivity engine. If you are interested in Cherry Studio Enterprise Edition and would like to learn more, request a quote, or schedule a demo, please feel free to contact us.

🔗 Related Projects

  • one-api: LLM API management and distribution system supporting mainstream models like OpenAI, Azure, and Anthropic. Features a unified API interface, suitable for key management and secondary distribution.

  • ublacklist: Blocks specific sites from appearing in Google search results

🚀 Contributors



📊 GitHub Stats

Stats

Star History

Star History Chart