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

# Project Overview

<figure><img src="/files/1e25668fcfc6ed3443aee00f31f046548ebe610e" alt=""><figcaption></figcaption></figure>

Follow our social accounts:[Twitter (X)](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 assistant platform that integrates multi-model conversations, agents, knowledge base management, AI drawing, translation, and more. Its highly customizable design, powerful extensibility, and friendly user experience make Cherry Studio 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 and improve your productivity and creativity.

<figure><img src="/files/0cd961fa6f5b93c4775e4f636e1703f508623ff0" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6c0d89c8a90c8ac33577ad4398ebde325844e397" alt=""><figcaption></figcaption></figure>

***

### **Core Features and Highlights**

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

* **One question, multiple answers**: Supports generating replies to the same question from multiple models at the same time, making it easy for users to compare the performance of different models, see [Chat interface](/docs/en-us/cherry-studio/preview/chat.md).
* **Auto grouping**: The conversation history of each assistant is automatically grouped and managed, making it easier for users to quickly find past conversations.
* **Conversation export**: Supports exporting full or partial conversations in multiple formats (such as Markdown, Word, etc.) for easy storage and sharing.
* **Highly customizable parameters**: In addition to basic parameter adjustments, it also supports user-defined custom parameters to meet personalized needs.
* **Assistant marketplace**: Built in with more than a thousand industry-specific assistants covering translation, programming, writing, and more, while also supporting user-defined assistants.
* **Multiple format rendering**: Supports Markdown rendering, formula rendering, HTML live preview, and more to improve content presentation.

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

* **Agent (Cherry Agent)**: AI that can independently read files, run commands, and complete multi-step tasks, see [Agent](/docs/en-us/cherry-studio/preview/agent.md).
* **Skill**: A "professional capability pack" added to assistants or agents (such as making Xiaohongshu image posts or drawing flowcharts), ready to use out of the box, see [Skill](/docs/en-us/advanced-basic/skills.md).
* **MCP**: Connect external tools and services through the Model Context Protocol (databases, Notion, GitHub, etc.), see [MCP tutorial](/docs/en-us/advanced-basic/mcp.md).
* **channels**: Deploy agents to IM platforms such as Feishu / WeChat / Telegram / Discord to act as group bots, see [channels](/docs/en-us/advanced-basic/agent-channels.md).
* **Scheduled tasks**: Let agents run automatically on a schedule (such as daily news briefings or weekly summaries), see [Scheduled tasks](/docs/en-us/advanced-basic/scheduled-tasks.md).

#### **3. Integration of multiple special features**

* **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 such as a dedicated translation panel, conversation translation, and prompt translation.
* **notes**: Built-in Markdown editor that works with conversation content, making it easy to organize and refine.
* **File management**: Files in conversations, drawings, and knowledge bases are managed in a unified category to avoid tedious searching.
* **Global search**: Supports quickly locating history and knowledge base content, improving productivity.

#### **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 full model list with one click, no manual configuration required.
* **Multiple key rotation**: Supports rotating multiple API keys to avoid rate limit issues.
* **Accurate avatar matching**: Automatically matches a dedicated avatar for each model, improving recognizability.
* **Custom providers**: Supports integration with third-party providers that conform to OpenAI, Gemini, Anthropic, and other standards, with strong compatibility.

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

* **Custom CSS**: Supports global style customization to create a unique 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 a variety of file formats, including PDF, DOCX, PPTX, XLSX, TXT, and MD.
* **Multiple data source support**: Supports local files, URLs, sitemaps, and even manually entered content as knowledge base sources.
* **Knowledge base export**: Supports exporting processed knowledge bases and sharing them for others to use.
* **Search verification support**: After importing a knowledge base, users can perform real-time search tests to view processing results and segmentation quality.

#### **7. Featured focus functions**

* **Quick Q\&A**: Call up a quick assistant in any scenario (such as WeChat or a browser) to get answers quickly.
* **Selection assistant**: After selecting text in any app, use the floating toolbar to call AI with one click for translation, explanation, optimization, summarization, and more.
* **Quick translation**: Supports quick translation of words or text in other scenarios.
* **Content summary**: Quickly summarize long text content to improve information extraction efficiency.
* **Explanation**: No complex prompt required; explain unfamiliar questions with one click.

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

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

***

### **Project advantages**

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

***

### **Use cases**

* **Knowledge management and search**: Quickly build and query a dedicated knowledge base through the local knowledge base feature, suitable for research, education, and more.
* **Multi-model conversations and creation**: Supports conversations with multiple models at the same time, helping users quickly obtain information or generate content.
* **Translation and office automation**: Built-in translation assistant 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">Twitter (X)</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:

```
GET https://docs.cherry-ai.com/docs/en-us/cherry-studio/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.