> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/en-us/cherry-studio/readme.md).

# Project Introduction

<figure><img src="https://3562065924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-31ab4eda3773fa840c2a385cef8d04539c08e851%2Fdocs-readme-banner1.png?alt=media" alt=""><figcaption></figcaption></figure>

Follow our social accounts:[X (Twitter)](https://x.com/CherryStudioHQ),[Xiaohongshu](https://www.xiaohongshu.com/user/profile/662b6853000000000b031d9a),[Weibo](https://weibo.com/u/7975656228),[Bilibili](https://space.bilibili.com/3546657515898892),[Douyin](https://www.douyin.com/user/MS4wLjABAAAAmw9A54m5J0hHVMQY5eGrVJ-EHDoOS0hgJ6M1F9MN2Tn2V163A0xrC4_KVzfmQSxC)

Join our communities:[QQ group](https://qm.qq.com/q/lo0D4qVZKi),[Telegram](https://t.me/CherryStudioAI),[Discord](https://discord.gg/wez8HtpxqQ),[WeChat group](https://www.cherry-ai.com/#Community)

***

Cherry Studio is an all-in-one AI workstation that combines multi-model conversations, agent AI, knowledge base management, AI drawing, translation, and more. Cherry Studio's highly customizable design, powerful extensibility, and friendly user experience make it an ideal choice for professional users and AI enthusiasts alike. Whether you are a beginner or a developer, you can find AI features that suit you in Cherry Studio, improving work efficiency and creativity.

<figure><img src="https://3562065924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FhQcD3xpW1SaCTuC8NpXx%2Fcherry-v2-agent-conversation-zh-cn.png?alt=media&#x26;token=de6c2c2c-413c-4c03-a7d1-2dc784e08e48" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3562065924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Ff88yMKP0Qp4HHDlL0TkI%2Fcherry-v2-model-provider-zh-cn.png?alt=media&#x26;token=ca06eae7-1071-407b-ba56-1497045240d4" alt=""><figcaption></figcaption></figure>

***

### **Core features and highlights**

#### **1. Basic conversation features**

* **One question, multiple answers**: Supports generating replies to the same question with multiple models at the same time, making it easy to compare the performance of different models; see the conversation interface for details.
* **Automatic grouping**: Conversation records for each assistant are automatically grouped and managed, making it easy for users to quickly find past conversations.
* **Conversation export**: Supports exporting complete or partial conversations in multiple formats (such as Markdown and Word), making storage and sharing easier.
* **Highly customizable parameters**: In addition to basic parameter adjustments, users can also enter custom parameters to meet personalized needs.
* **Preset assistants**: Browse and use preset assistants in the assistant module during conversations, covering scenarios such as translation, programming, and writing, while also supporting user-defined assistants.
* **Multiple format rendering**: Supports Markdown rendering, formula rendering, HTML live preview, and more, improving content presentation.

#### **2. Agents and automation**

* **Agent**: Can **Work** read files, run commands, and complete multi-step tasks on the page; see Work for details.
* **Skills**: "professional capability packs" added to assistants or agents (such as making Xiaohongshu image-text posts or drawing flowcharts), ready to use out of the box; see Skills for details.
* **MCP**: Connect external tools and services through the Model Context Protocol (databases, Notion, GitHub, etc.); see [MCP tutorial](/docs/en-us/advanced-basic/extensions/mcp.md).
* **Channels**: Deploy agents to IM platforms such as Feishu, WeChat, Telegram, and Discord to act as group bots; see Channels for details.
* **Scheduled tasks**: Let agents run automatically on a schedule (such as daily news briefings or weekly summaries); see Scheduled tasks for details.

#### **3. Integration of multiple featured functions**

* **AI drawing**: Provides a dedicated drawing panel, where users can generate high-quality images through natural language descriptions.
* **AI mini programs**: Integrates a variety of free web-based AI tools, allowing direct use without switching browsers.
* **Translation features**: Supports multiple translation scenarios, including a dedicated translation panel, conversation translation, and prompt translation.
* **Notes**: Includes a built-in Markdown editor that works seamlessly with conversation content, making it easy to organize and preserve.
* **File management**: Unified categorized management of files in conversations, drawings, and knowledge bases, avoiding cumbersome searching.
* **Global search**: Supports quickly locating history records and knowledge base content, improving work efficiency.

#### **4. Unified management mechanism for multiple providers**

* **Provider model aggregation**: Supports unified access to models from mainstream providers such as OpenAI, Gemini, Anthropic, and Azure.
* **Automatic model retrieval**: Get the complete model list with one click, no manual configuration required.
* **Multiple-key rotation**: Supports rotating multiple API keys to avoid rate-limit issues.
* **Precise avatar matching**: Automatically matches a dedicated avatar for each model, improving recognizability.
* **Custom providers**: Supports integration with third-party providers that comply with OpenAI, Gemini, Anthropic, and other standards, with strong compatibility.

#### **5. Highly customizable interface and layout**

* **Custom CSS**: Supports global style customization, creating your own interface style.
* **Custom conversation layout**: Supports list or bubble-style layouts, and allows custom message styles (such as code snippet styles).
* **Custom avatars**: Supports setting personalized avatars for the software and assistants.
* **Custom sidebar menu**: Users can hide or reorder sidebar features as needed to optimize the experience.

#### **6. Local knowledge base system**

* **Multiple format support**: Supports importing many file formats, including PDF, DOCX, PPTX, XLSX, TXT, and MD.
* **Multiple data source support**: Supports using local files, URLs, sitemaps, or even manually entered content as knowledge base sources.
* **Knowledge base export**: Supports exporting processed knowledge bases to share with others.
* **Search verification support**: After importing a knowledge base, users can perform real-time retrieval tests to view processing results and chunking effects.

#### **7. Featured spotlight functions**

* **Quick Q\&A**: Call up a quick assistant in any scenario (such as WeChat or a browser) to get answers quickly.
* **Text selection assistant**: After selecting text in any app, use the floating toolbar to invoke AI with one click for translation, explanation, optimization, summarization, and more.
* **Quick translation**: Supports fast translation of words or text in other scenarios.
* **Content summary**: Quickly summarize long-form content to improve information extraction efficiency.
* **Explanation**: Explain unfamiliar questions with one click, without complicated prompts.

#### **8. Data protection**

* **Multiple backup options**: Supports local backups, WebDAV backups, and scheduled backups to ensure data safety.
* **Data security**: Supports fully local usage scenarios; combined with local large models, it avoids the risk of data leakage.

***

### **Project advantages**

1. **Beginner-friendly**: Cherry Studio is committed to lowering the technical barrier, allowing even beginners to get started quickly and focus on work, study, or creation.
2. **Comprehensive documentation**: Provides detailed user documentation and a common issue troubleshooting guide to help users solve problems quickly.
3. **Continuous iteration**: The project team actively responds to user feedback, continuously optimizes features, and ensures healthy project development.
4. **Open source and extensibility**: Supports user customization and extension through open-source code to meet personalized needs.

***

### **Applicable scenario**

* **Knowledge management and querying**: Quickly build and query a dedicated knowledge base through the local knowledge base feature, suitable for research, education, and other fields.
* **Multi-model conversation and creation**: Supports simultaneous conversations with multiple models, helping users quickly obtain information or generate content.
* **Translation and office automation**: Built-in translation assistants and file processing features, suitable for users who need cross-language communication or document processing.
* **AI drawing and design**: Generate images through natural language descriptions to meet creative design needs.

### Star History

![Star History](https://urlscan.io/liveshot/?width=1300\&height=620\&url=https://cherrystarhistory.ocool.online/)

## Follow our social accounts

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="https://www.xiaohongshu.com/user/profile/662b6853000000000b031d9a?xsec_token=YB_1nKvlH4r5hPYVVbbsNHF8Y6n6AKlm5-DaggPCtd2DQ%3D&#x26;xsec_source=app_share&#x26;xhsshare=CopyLink&#x26;appuid=662b6853000000000b031d9a&#x26;apptime=1738627324&#x26;share_id=ace5db41b5954fab8d98a2a7865a62bc&#x26;share_channel=copy_link">Xiaohongshu</a></td><td><a href="/files/a631e02694df98b0792efdbf70ed210a393cb87e">/files/a631e02694df98b0792efdbf70ed210a393cb87e</a></td><td><a href="https://www.xiaohongshu.com/user/profile/662b6853000000000b031d9a?xsec_token=YB_1nKvlH4r5hPYVVbbsNHF8Y6n6AKlm5-DaggPCtd2DQ%3D&#x26;xsec_source=app_share&#x26;xhsshare=CopyLink&#x26;appuid=662b6853000000000b031d9a&#x26;apptime=1738627324&#x26;share_id=ace5db41b5954fab8d98a2a7865a62bc&#x26;share_channel=copy_link">https://www.xiaohongshu.com/user/profile/662b6853000000000b031d9a?xsec_token=YB_1nKvlH4r5hPYVVbbsNHF8Y6n6AKlm5-DaggPCtd2DQ%3D&#x26;xsec_source=app_share&#x26;xhsshare=CopyLink&#x26;appuid=662b6853000000000b031d9a&#x26;apptime=1738627324&#x26;share_id=ace5db41b5954fab8d98a2a7865a62bc&#x26;share_channel=copy_link</a></td></tr><tr><td><a href="https://b23.tv/hIfGgDW">Bilibili</a></td><td><a href="/files/b46fdd1ba39ee5a4bf8118bf059d8833376efbe7">/files/b46fdd1ba39ee5a4bf8118bf059d8833376efbe7</a></td><td><a href="https://b23.tv/hIfGgDW">https://b23.tv/hIfGgDW</a></td></tr><tr><td><a href="https://weibo.com/u/7975656228">Weibo</a></td><td><a href="/files/bb573a8b3822bcd82f4940bf42ac7e65dec75a7e">/files/bb573a8b3822bcd82f4940bf42ac7e65dec75a7e</a></td><td><a href="https://weibo.com/u/7975656228">https://weibo.com/u/7975656228</a></td></tr><tr><td><a href="https://v.douyin.com/ifTpX4X7">Douyin</a></td><td><a href="/files/2d9d32991f2081eb7dc9464c97056e5d47475335">/files/2d9d32991f2081eb7dc9464c97056e5d47475335</a></td><td><a href="https://v.douyin.com/ifTpX4X7">https://v.douyin.com/ifTpX4X7</a></td></tr><tr><td><a href="https://x.com/CherryStudioHQ?t=DYR0ulaLur-bO4Us3bG79A&#x26;s=05">X (Twitter)</a></td><td><a href="/files/92320f07e9e3b47152509a6d6f292e53836c2cd0">/files/92320f07e9e3b47152509a6d6f292e53836c2cd0</a></td><td><a href="https://x.com/CherryStudioHQ?t=DYR0ulaLur-bO4Us3bG79A&#x26;s=05">https://x.com/CherryStudioHQ?t=DYR0ulaLur-bO4Us3bG79A&#x26;s=05</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/en-us/cherry-studio/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
