Settings

Feature Overview

Files

The Files interface displays all files related to conversations, paintings, knowledge bases, etc. You can centrally manage and view these files on this page.

Default Model Settings

Default Assistant Model

When the assistant does not have a default assistant model configured, the model selected by default for new conversations is the one set here. The model used for prompt optimization and word-selection assistant is also configured in this section.

Topic Naming Model

After each conversation, a model is called to generate a topic name for the dialog. The model set here is the one used for naming.

Translation Model

The translation feature in input boxes for conversations, painting, etc., and the translation model in the translation interface all use the model set here.

Quick Assistant Model

The model used for the quick assistant feature. For details, see Quick Assistant.

Mini Programs

On the Mini Programs page, you can use web versions of AI-related programs from major service providers within the client. Currently, custom addition and removal are not supported.

General Settings

On this page, you can configure the software's interface language, proxy settings, and other options.

Installation Tutorial

Drawing

The drawing feature currently supports painting models from DMXAPI, TokenFlux, AiHubMix, and SiliconFlow. You can register an account at SiliconFlow and add it as a provider to use this feature.

For questions about parameters, hover your mouse over the ? icon in corresponding areas to view descriptions.

Knowledge Base

For knowledge base usage, please refer to the in the advanced tutorials.

Quick Assistant

Quick Assistant is a convenient tool provided by Cherry Studio that allows you to quickly access AI functions in any application, enabling instant operations like asking questions, translation, summarization, and explanations.

Enable Quick Assistant

1. Open Settings: Navigate to Settings -> Shortcuts -> Quick Assistant.

2. Enable Switch: Find and toggle on the Quick Assistant button.

1. Set Shortcut Key (Optional):

   • Default shortcut for Windows: Ctrl + E

   • Default shortcut for macOS: ⌘ + E

   • Customize your shortcut here to avoid conflicts or match your usage habits.

Using Quick Assistant

1. Activate: Press your configured shortcut key (or default shortcut) in any application to open Quick Assistant.

2. Interact: Within the Quick Assistant window, you can directly perform:

   • Quick Questions: Ask any question to the AI.

   • Text Translation: Input text to be translated.

   • Content Summarization: Input long text for summarization.

   • Explanation: Input concepts or terms requiring explanation.
3. Close: Press ESC or click anywhere outside the Quick Assistant window.

Tips & Tricks

• Shortcut Conflicts: Modify shortcuts if defaults conflict with other applications.

• Explore More Functions: Beyond documented features, Quick Assistant may support operations like code generation and style transfer. Continuously explore during usage.

• Feedback & Improvements: Report issues or suggestions to the Cherry Studio team via .

macOS

1. First, visit the official download page to download the Mac version, or click the direct link below

   Please download the chip-specific version matching your Mac

1. After downloading, click here

1. Drag the icon to install

Find the Cherry Studio icon in Launchpad and click it. If the Cherry Studio main interface opens, the installation is successful.

This interface allows for local and cloud data backup and recovery, local data directory inquiry and cache clearing, export settings, and third-party connections.

Data Backup

Currently, data backup supports three methods: local backup, WebDAV backup, and S3-compatible storage (object storage) backup. For specific introductions and tutorials, please refer to the following documents:

Export Settings

Export settings allow you to configure the export options displayed in the export menu, as well as set the default path for Markdown exports, display styles, and more.

Third-Party Connections

Third-party connections allow you to configure Cherry Studio's connection with third-party applications for quickly exporting conversation content to your familiar knowledge management applications. Currently supported applications include: Notion, Obsidian, SiYuan Note, Yuque, Joplin. For specific configuration tutorials, please refer to the following documents:

Agent

The Agents page is an assistant marketplace where you can select or search for desired model presets. Click on a card to add the assistant to your conversation page's assistant list.

You can also edit and create your own assistants on this page.

• Click My, then Create Agent to start building your own assistant.

Windows

Visit the Official Website

Click to download and select the appropriate version

Wait for the Download to Complete

If the browser warns that the file is not trusted, simply choose to keep it Keep → Trust Cherry-Studio

Open the File

Install

Direct Download

Windows Version

Installer (Setup)

Portable Version

macOS Version

Linux Version

Cloud Drive Download

Quark

Project Planning

To-Do List

• Quick Pop-up (Clipboard reading, quick questions, explanation, translation, summarization)

• Multi-model Response Comparison

• Support SSO Login using provider credentials

• Enable Internet access for all models

• Release first official version

• Plugin functionality (JavaScript)

• Browser extension (Text selection translation/summarization/add to knowledge base)

• iOS & Android client

• AI Notes

• Voice input/output (AI calls)

• Data backup with customizable backup content

Key translation notes:

1. Preserved all Markdown formatting (headings, checkboxes)

2. Technical terms remain unchanged: "JavaScript", "SSO", "iOS", "Android"

3. Action descriptions standardized: "Quick Pop-up" for 快捷弹窗, "multi-model" for 多模型

4. Functional translations: "划词翻译" → "text selection translation"

5. Feature localization: "AI 通话" → "AI calls"

6. Maintained present tense for consistency

7. Preserved special characters and list formatting

8. Translated bracket content while keeping technical references (JavaScript)

9. Proper noun capitalization: "AI Notes"

Model Service Configuration

OneAPI and its Fork Projects

Provider Settings

This page only introduces the interface features. For configuration tutorials, please refer to the Provider Configuration tutorial in the Basic Tutorials.

API Key

In Cherry Studio, a single provider supports multiple keys for round-robin usage, with the polling method being sequential from front to back.

• Add multiple keys separated by English commas. For example:

sk-xxxx1,sk-xxxx2,sk-xxxx3,sk-xxxx4

API Address

When using built-in providers, it's generally not necessary to fill in the API address. If modification is needed, strictly follow the address provided in the official documentation.

If the provider gives an address in the format https://xxx.xxx.com/v1/chat/completions, only fill in the root address part (https://xxx.xxx.com).

Cherry Studio will automatically append the remaining path (/v1/chat/completions). Failure to comply may result in failure to function properly.

Adding Models

Generally, clicking the Manage button at the bottom left of the provider configuration page will automatically fetch all supported models. Click + in the fetched list to add models to the model list.

Connectivity Check

Click the check button next to the API Key input box to test whether the configuration is successful.

Translation

Cherry Studio's translation feature provides you with fast and accurate text translation services, supporting mutual translation between multiple languages.

Interface Overview

The translation interface mainly consists of the following components:

1. Source Language Selection Area:

   • Any Language: Cherry Studio will automatically identify the source language and perform translation.

2. Target Language Selection Area:

   • Dropdown Menu: Select the language you wish to translate the text into.

3. Settings Button:

   • Clicking will jump to .

4. Scroll Synchronization:

   • Toggle to enable scroll sync (scrolling in either side will synchronize the other).

5. Text Input Box (Left):

   • Input or paste the text you need to translate.

6. Translation Result Box (Right):

   • Displays the translated text.

   • Copy Button: Click to copy the translation result to clipboard.

7. Translate Button:

   • Click this button to start translation.

8. Translation History (Top Left):

   • Click to view translation history records.

Usage Steps

1. Select Target Language:

   • Choose your desired translation language in the Target Language Selection Area.

2. Input or Paste Text:

   • Enter or paste the text to be translated in the left text input box.

3. Start Translation:

   • Click the Translate button.

4. View and Copy Results:

   • Translation results will appear in the right result box.

   • Click the copy button to save the result to clipboard.

Frequently Asked Questions (FAQ)

• Q: What to do about inaccurate translations?

  • A: While AI translation is powerful, it's not perfect. For professional fields or complex contexts, manual proofreading is recommended. You may also try switching different models.

• Q: Which languages are supported?

  • A: Cherry Studio translation supports multiple major languages. Refer to Cherry Studio's official website or in-app instructions for the specific supported languages list.

• Q: Can entire files be translated?

  • A: The current interface primarily handles text translation. For document translation, please use Cherry Studio's conversation page to add files for translation.

• Q: How to handle slow translation speeds?

  • A: Translation speed may be affected by network connection, text length, or server load. Ensure stable network connectivity and be patient.

MCP Usage Tutorial

Personalization Settings

Contributing Documentation

Email [email protected] to obtain editing privileges

Subject: Request for Cherry Studio Docs Editing Privileges

Body: State your reason for applying

Data Settings

Free Internet Mode

Follow our social accounts: Twitter (X), Xiaohongshu, Weibo, Bilibili, Douyin

Join our community: QQ Group (575014769), Telegram, Discord, WeChat Group (Click to view)

Cherry Studio is an all-in-one AI assistant platform integrating multi-model conversations, knowledge base management, AI painting, translation, and more. Cherry Studio's highly customizable design, powerful extensibility, and user-friendly experience make it an ideal choice for both professional users and AI enthusiasts. Whether you are a beginner or a developer, you can find suitable AI features in Cherry Studio to improve work efficiency and creativity.

Core Features and Highlights

1. Basic Conversation Features

• Multi-model Responses: Supports generating responses to the same question simultaneously from multiple models, allowing users to compare the performance of different models. For details, see Chat Interface.

• Automatic Grouping: Conversation records for each assistant are automatically grouped for easy access to historical conversations.

• Conversation Export: Supports exporting full or partial conversations to various formats (e.g., Markdown, Word), convenient for storage and sharing.

• Highly Customizable Parameters: In addition to basic parameter adjustments, it also supports users filling in custom parameters to meet personalized needs.

• Assistant Marketplace: Built-in over a thousand industry-specific assistants covering translation, programming, writing, and more, also supporting user-defined assistants.

• Multi-format Rendering: Supports Markdown rendering, formula rendering, real-time HTML preview, and other features to enhance content display.

2. Integrated Unique Features

• AI Painting: Provides a dedicated painting panel, allowing users to generate high-quality images through natural language descriptions.

• AI Mini-Apps: Integrates various free web-based AI tools, allowing direct use without switching browsers.

• Translation Function: Supports various translation scenarios, including dedicated translation panels, conversation translation, and prompt translation.

• File Management: Files in conversations, paintings, and knowledge bases are uniformly categorized and managed to avoid tedious searching.

• Global Search: Supports quickly locating historical records and knowledge base content, improving work efficiency.

3. Unified Multi-Provider Management Mechanism

• Provider Model Aggregation: Supports unified invocation of models from mainstream providers such as OpenAI, Gemini, Anthropic, Azure.

• Automatic Model Retrieval: One-click retrieval of the complete model list, no manual configuration required.

• Multi-key Rotation: Supports rotating multiple API keys to avoid rate limit issues.

• Accurate Avatar Matching: Automatically matches exclusive avatars for each model to improve recognition.

• Custom Providers: Supports the integration of third-party providers that comply with OpenAI, Gemini, Anthropic, and other specifications, offering strong compatibility.

4. 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 (e.g., code snippet styles).

• Custom Avatars: Supports setting personalized avatars for software and assistants.

• Custom Sidebar Menu: Users can hide or sort sidebar features according to their needs to optimize the user experience.

5. Local Knowledge Base System

• Multi-format Support: Supports importing various file formats such as PDF, DOCX, PPTX, XLSX, TXT, 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 for sharing with others.

• Search Inspection Support: After importing the knowledge base, users can perform real-time retrieval tests to check processing results and segmentation effects.

6. Highlighted Focus Features

• Quick Q&A: Invoke a quick assistant in any scenario (e.g., WeChat, browser) to quickly get answers.

• Quick Translate: Supports quick translation of words or text in other scenarios.

• Content Summarization: Quickly summarizes long text content to improve information extraction efficiency.

• Explanation: Explains unclear questions with one click, no complex prompts needed.

7. Data Security

• Multiple Backup Solutions: Supports local backup, WebDAV backup, and timed backup to ensure data security.

• Data Security: Supports full local usage scenarios, combined with local large models, to avoid data leakage risks.

Project Advantages

1. Beginner-Friendly: Cherry Studio is committed to lowering technical barriers, allowing beginners to quickly get started and focus on work, study, or creation.

2. Comprehensive Documentation: Provides detailed user documentation and a common issues handbook to help users quickly resolve problems.

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.

Applicable Scenarios

• Knowledge Management and Query: Quickly build and query exclusive knowledge bases through the local knowledge base feature, suitable for research, education, and other fields.

• Multi-model Conversation and Creation: Supports simultaneous multi-model conversations, helping users quickly obtain information or generate content.

• Translation and Office Automation: Built-in translation assistant and file processing features, suitable for users needing cross-language communication or document processing.

• AI Painting and Design: Generates images through natural language descriptions, meeting creative design needs.

Star History

Follow Our Social Accounts

Alibaba Cloud Bailian

1. Log in to Alibaba Cloud Bailian. If you don't have an Alibaba Cloud account, you'll need to register.

2. Click the Create My API-KEY button in the upper-right corner.
3. In the popup window, select the default workspace (or customize it if desired). You can optionally add a description.
4. Click the Confirm button in the lower-right corner.

5. You should now see a new entry in the list. Click the View button on the right.
6. Click the Copy button.
7. Go to Cherry Studio, navigate to Settings → Model Services → Alibaba Cloud Bailian, and paste the copied API key into the API Key field.
8. You can adjust related settings as described in Model Services, then start using the service.

OpenAI

Obtaining an API Key

• On the official API Key page, click + Create new secret key

• Copy the generated key, then open CherryStudio's Vendor Settings

• Find the OpenAI vendor and enter the key you just obtained

• Click Manage or Add at the bottom, add supported models, and toggle the vendor switch at the top right to start using.

Cherry Studio data backup supports backup via S3 compatible storage (object storage). Common S3 compatible storage services include: AWS S3, Cloudflare R2, Alibaba Cloud OSS, Tencent Cloud COS, and MinIO.

Based on S3 compatible storage, multi-terminal data synchronization can be achieved by the method of Computer A $\xrightarrow{\text{Backup}}$ S3 Storage $\xrightarrow{\text{Restore}}$ Computer B.

Configure S3 Compatible Storage

1. Create an object storage bucket, and record the bucket name. It is highly recommended to set the bucket to private read/write to prevent backup data leakage!!

2. Refer to the documentation, go to the cloud service console to obtain information such as Access Key ID, Secret Access Key, Endpoint, Bucket, Region for S3 compatible storage.

   • Endpoint: The access address for S3 compatible storage, usually in the form of https://<bucket-name>.<region>.amazonaws.com or https://<ACCOUNT_ID>.r2.cloudflarestorage.com.

   • Region: The region where the bucket is located, such as us-west-1, ap-southeast-1, etc. For Cloudflare R2, please fill in auto.

   • Bucket: The bucket name.

   • Access Key ID and Secret Access Key: Credentials used for authentication.

   • Root Path: Optional, specifies the root path when backing up to the bucket, default is empty.

   • Related Documentation

     • AWS S3: Obtain Access Key ID and Secret Access Key

     • Cloudflare R2: Obtain Access Key ID and Secret Access Key

     • Alibaba Cloud OSS: Obtain Access Key ID and Access Key Secret

     • Tencent Cloud COS: Obtain SecretId and SecretKey

3. Fill in the above information in the S3 backup settings, click the backup button to perform backup, and click the manage button to view and manage the list of backup files.

Data Storage Instructions

Data added to the Cherry Studio knowledge base is entirely stored locally. During the addition process, a copy of the document will be placed in the Cherry Studio data storage directory.

Vector Database: https://turso.tech/libsql

After documents are added to the Cherry Studio knowledge base, they are segmented into multiple fragments. These fragments are then processed by the embedding model.

When using large models for Q&A, relevant text fragments matching the query will be retrieved and processed together by the large language model.

If you have data privacy requirements, it is recommended to use local embedding databases and local large language models.

Google Gemini

Obtaining API Key

• Before obtaining the Gemini API key, you need a Google Cloud project (skip this step if you already have one).

• Go to to create a project, fill in the project name, and click "Create Project".

• On the official , click Create API Key.

• Copy the generated key, then open CherryStudio's .

• Find the Gemini service provider and enter the key you just obtained.

• Click "Manage" or "Add" at the bottom, add the supported models, then toggle the service provider switch at the top right to start using.

Vertex AI

Tutorial Overview

1. Obtaining API Key

• Before obtaining the Gemini API Key, you need to have a Google Cloud project (if you already have one, this process can be skipped)

• Go to to create a project, fill in the project name and click Create Project

• Access the

• Enable in the created project

2. Setting API Access Permissions

• Open the permissions page and create a service account

• On the service account management page, find the service account you just created, click Keys and create a new JSON key

• After successful creation, the key file will be automatically saved to your computer in JSON format. Please store it securely

3. Configuring Vertex AI in Cherry Studio

• Select Vertex AI as the service provider

• Fill in the corresponding fields from the JSON file

Click , and you can start using it!

Clear CSS Settings

• Open the console by clicking on the CherryStudio window and pressing Ctrl+Shift+I (MacOS: command+option+I).

• In the opened console window, click Console

• Then manually enter document.getElementById('user-defined-custom-css').remove(). Copying and pasting will most likely not work.

• After entering, press Enter to confirm and clear the CSS settings. Then, go back to CherryStudio's display settings and remove the problematic CSS code.

GitHub Copilot

To use GitHub Copilot, you must first have a GitHub account and subscribe to the GitHub Copilot service. The free subscription tier is acceptable, but note that it does not support the latest Claude 3.7 model. For details, refer to the .

Obtain Device Code

Click "Log in with GitHub" to generate and copy your Device Code.

Enter Device Code in Browser and Authorize

After obtaining your Device Code, click the link to open your browser. Log in to your GitHub account, enter the Device Code, and grant authorization.

After successful authorization, return to Cherry Studio and click "Connect GitHub". Your GitHub username and avatar will appear upon successful connection.

Click "Manage" to Get Model List

Click the "Manage" button below, which will automatically fetch the currently supported models list online.

Common Issues

Failed to Obtain Device Code, Please Retry

The current implementation uses Axios for network requests. Note that Axios does not support SOCKS proxies. Please use a system proxy or HTTP proxy, or avoid setting proxies within CherryStudio and use a global proxy instead. First, ensure your network connection is stable to prevent Device Code retrieval failures.

Knowledge base document preprocessing requires upgrading Cherry Studio to v1.4.8 or higher.

Configure OCR Provider

After clicking 'Get API KEY', the application address will open in your browser. Click 'Apply Now' to fill out the form and obtain the API KEY, then fill it into the API KEY field.

Configure Knowledge Base Document Preprocessing

Configure as shown above in the created knowledge base to complete the knowledge base document preprocessing configuration.

Upload Documents

You can check knowledge base results by searching in the top right corner.

Usage in Conversation

Knowledge Base Usage Tips: When using more capable models, you can change the knowledge base search mode to intent recognition. Intent recognition can describe your questions more accurately and broadly.

Enable Knowledge Base Intent Recognition

SiliconFlow

1. Configuring SiliconCloud Model Service

1.2 Click the settings at the bottom left, and select 【SiliconFlow】 in the model service

1.2 Click the link to get SiliconCloud API Key

1. Log in to (if not registered, the first login will automatically register an account)

2. Visit to create a new key or copy an existing one

1.3 Click Manage to add models

2. Using the Model Service

1. Click the "Chat" button in the left menu bar

2. Enter text in the input box to start chatting

3. You can switch models by selecting the model name in the top menu

MCP Environment Installation

MCP (Model Context Protocol) is an open-source protocol designed to provide context information to large language models (LLMs) in a standardized manner. For more details about MCP, see .

Using MCP in Cherry Studio

The following demonstrates how to use MCP in Cherry Studio using the fetch feature as an example. Detailed information can be found in the .

Prerequisites: Installing uv and bun

In Settings > MCP Server, click the Install button to automatically download and install them. Downloads are sourced directly from GitHub and may be slow with a high probability of failure. Installation success should be verified by checking for files in the directories mentioned below.

Executable Installation Directories:

Windows: C:\Users\username\.cherrystudio\bin

macOS/Linux: ~/.cherrystudio/bin

If unable to install normally:

You can create symlinks from the system's corresponding commands to these locations. If the directory doesn't exist, create it manually. Alternatively, manually download executables and place them in this directory:

Bun: UV:

Font Recommendations

Frequently Asked Questions

1. mcp-server-time

Solution

Enter in the "Parameters" field:

Configuring and Using MCP

1. Open Cherry Studio settings.

2. Find the MCP Server option.

3. Click Add Server.

4. Fill in the parameters for the MCP Server (). This may include:

   • Name: Custom name, e.g., fetch-server

   • Type: Select STDIO

   • Command: Enter uvx

   • Arguments: Enter mcp-server-fetch

   • (Additional parameters may be required depending on the specific Server)

5. Click Save.

Enabling MCP Service in the Chatbox

• After successfully adding the MCP server in MCP Server settings

Demonstration of Usage Effects

As shown above, after integrating MCP's fetch functionality, Cherry Studio can better understand user query intentions. It retrieves relevant information from the web to provide more accurate and comprehensive responses.

Business Cooperation

Contact Person: Mr. Wang 📮: [email protected] 📱: 18954281942 (Not a customer service hotline)

Commercial license details:

Built-in MCP Configurations

@cherry/mcp-auto-install

Automatically install MCP service (Beta)

@cherry/memory

Persistence memory base implementation based on local knowledge graph. This enables models to remember user-related information across different conversations.

MEMORY_FILE_PATH=/path/to/your/file.json

@cherry/sequentialthinking

An MCP server implementation providing tools for dynamic and reflective problem-solving through structured thought processes.

@cherry/brave-search

An MCP server implementation integrated with Brave Search API, offering dual functionality for both web and local searches.

BRAVE_API_KEY=YOUR_API_KEY

@cherry/fetch

MCP server for retrieving web content from URLs.

@cherry/filesystem

Node.js server implementing the Model Context Protocol (MCP) for file system operations.

Feedback & Suggestions

Telegram Discussion Group

Join the Telegram discussion group for assistance: https://t.me/CherryStudioAI

QQ Group

QQ Group (1025067911)

GitHub Issues

GitHub Issues: https://github.com/CherryHQ/cherry-studio/issues/new/choose

Email

Email the developers: [email protected]

Contribute Code

We welcome contributions to Cherry Studio! You can contribute in the following ways:

1. Contribute code: Develop new features or optimize existing code.

2. Fix bugs: Submit bug fixes you discover.

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 assist users.

7. Promote usage: Spread the word about Cherry Studio.

How to Participate

Email [email protected]

Email subject: Application to Become a Developer Email content: Reason for Application

Common Model Reference Information

Privacy Policy

Welcome to Cherry Studio (hereinafter referred to as "this software" or "we"). We highly value your privacy protection, and this Privacy Policy explains how we handle and protect your personal information and data. Please read and understand this agreement carefully before using this software:

1. Scope of Information We Collect

To optimize user experience and improve software quality, we may only collect the following anonymous non-personal information: • Software version information; • Function activity and usage frequency; • Anonymous crash and error log information;

The above information is completely anonymous, does not involve any personally identifiable data, and cannot be associated with your personal information.

2. Information We Do Not Collect

To maximize the protection of your privacy, we explicitly commit: • Will not collect, store, transmit, or process the model service API Key information you input into this software; • Will not collect, store, transmit, or process any conversation data generated during your use of this software, including but not limited to chat content, instruction information, knowledge base information, vector data, and other custom content; • Will not collect, store, transmit, or process any personally identifiable sensitive information.

3. Data Interaction Description

This software uses the API Key of third-party model service providers that you apply for and configure yourself to complete model invocation and conversation functions. The model services you use (such as large language models, API interfaces, etc.) are provided and fully managed by the third-party provider you choose, and Cherry Studio only serves as a local tool providing interface invocation functionality with third-party model services.

Therefore: • All conversation data generated between you and the model service is unrelated to Cherry Studio. We neither participate in data storage nor perform any form of data transmission or relay; • You need to independently review and accept the privacy policies and relevant regulations of the corresponding third-party model service providers. These services' privacy policies can be viewed on each provider's official website.

4. Third-Party Model Service Provider Privacy Policy Statement

You shall bear any privacy risks that may arise from using third-party model service providers. For specific privacy policies, data security measures, and related responsibilities, please refer to the relevant content on the official websites of your chosen model service providers. We assume no responsibility for these matters.

5. Agreement Updates and Modifications

This agreement may be appropriately adjusted with software version updates. Please check it periodically. When substantive changes occur to the agreement, we will notify you through appropriate means.

6. Contact Us

If you have any questions regarding this agreement or Cherry Studio's privacy protection measures, please feel free to contact us at any time.

Thank you for choosing and trusting Cherry Studio. We will continue to provide you with a secure and reliable product experience.

Shortcut Keys Settings

This interface allows you to enable/disable and configure shortcut keys for certain functions. Please refer to the on-screen instructions for specific setup.

Infini-AI Cloud

Have you ever experienced: saving 26 insightful articles in WeChat that you never open again, storing over 10 scattered files in a "Study Materials" folder on your computer, or trying to recall a theory you read half a year ago only to remember fragmented keywords? And when daily information exceeds your brain's processing limit, 90% of valuable knowledge gets forgotten within 72 hours. Now, by leveraging the Infini-AI large model service platform API + Cherry Studio to build a personal knowledge base, you can transform dust-collecting WeChat articles and fragmented course content into structured knowledge for precise retrieval.

1. Building Personal Knowledge Base

1. Infini-AI API Service: The Stable "Thinking Hub" of Knowledge Bases

Serving as the "thinking hub" of knowledge bases, the Infini-AI large model service platform offers robust API services including full-capacity DeepSeek R1 and other model versions. Currently free to use without barriers after registration. Supports mainstream embedding models (bge, jina) for knowledge base construction. The platform continuously updates with the latest, most powerful open-source models, covering multiple modalities like images, videos, and audio.

2. Cherry Studio: Zero-Code Knowledge Base Setup

Compared to RAG knowledge base development requiring 1-2 months deployment time, Cherry Studio offers a significant advantage: zero-code operation. Instantly import multiple formats like Markdown/PDF/web pages – parsing 40MB files in 1 minute. Easily add local folders, saved WeChat articles, and course notes.

II. 3 Steps to Build Your Personal Knowledge Manager

Step 1: Basic Preparation

1. Download the suitable version from Cherry Studio official site (https://cherry-ai.com/)

2. Register account: Log in to Infini-AI platform (https://cloud.infini-ai.com/genstudio/model?cherrystudio)

• Get API key: Select "deepseek-r1" in Model Square, create and copy the API key + model name

Step 2: CherryStudio Settings

Go to model services → Select Infini-AI → Enter API key → Activate Infini-AI service

After setup, select the large model during interaction to use Infini-AI API in CherryStudio. Optional: Set as default model for convenience

Step 3: Add Knowledge Base

Choose any version of bge-series or jina-series embedding models from Infini-AI platform

III. Real User Scenario Test

• After importing study materials, query: "Outline core formula derivations in Chapter 3 of 'Machine Learning'"

Result Demonstration

Notion Configuration Tutorial

Cherry Studio supports importing topics into Notion databases.

Step One

Visit Notion Integrations to create an application

Step Two

Create an application

Name: Cherry Studio Type: Select the first option Icon: You can save this image

Step Three

Copy the secret key and enter it in Cherry Studio settings

Step Four

Open Notion website and create a new page. Select database type below, name it Cherry Studio, and connect as shown

Step Five

If your Notion database URL looks like this: https://www.notion.so/<long_hash_1>?v=<long_hash_2> Then the Notion database ID is the part <long_hash_1>

Step Six

Fill in Page Title Field Name: If your interface is in English, enter Name If your interface is in Chinese, enter 名称

Step Seven

Congratulations! Notion configuration is complete ✅ You can now export Cherry Studio content to your Notion database

Tavily Internet Registration Tutorial

1. Tavily Official Website

https://app.tavily.com/home

2. Detailed Tavily Registration Steps

Visit the official website above, or go to Cherry Studio > Settings > Web Search > click "Get API Key" to directly access Tavily's login/registration page.

1. Click "Sign up" and enter your email (or use Google/GitHub account) followed by your password.

1. 🚨🚨🚨[Critical Step] After registration, a dynamic verification code is required. Scan the QR code to generate a one-time code.

1. Search "Tencent Authenticator" in WeChat Mini Programs:

3. 🎉 Registration Successful 🎉

After completing these steps, you'll see the dashboard. Copy the API key to Cherry Studio to start using Tavily!

ByteDance (Doubao)

• Log in to Volcano Engine

• Or click here to go directly

Obtaining the API Key

• Click API Key Management in the sidebar

• Create an API Key

• After creation, click the eye icon next to the created API Key to reveal and copy it

• Paste the copied API Key into Cherry Studio and then toggle the provider switch to ON

Enabling and Adding Models

• Enable the models you need at the bottom of the sidebar in the Ark console under Enablement Management. You can enable the Doubao series, DeepSeek, and other models as required

• In the Model List Documentation, find the model ID corresponding to the desired model

• Open Cherry Studio's Model Services settings and locate Volcano Engine

• Click Add, then paste the previously obtained model ID into the model ID text field

• Follow this process to add models one by one

API Address

There are two ways to write the API address:

• First, the default in the client: https://ark.cn-beijing.volces.com/api/v3/

• Second: https://ark.cn-beijing.volces.com/api/v3/chat/completions#

SiYuan Note Configuration Tutorial

Supports exporting topics and messages to SiYuan Note.

Step 1

Open SiYuan Note and create a notebook

Step 2

Open notebook settings and copy the Notebook ID

Step 3

Paste the copied notebook ID into Cherry Studio settings

Step 4

Fill in the SiYuan Note address

• Local Typically http://127.0.0.1:6806

• Self-hosted Use your domain http://note.domain.com

Step 5

Copy the SiYuan Note API Token

Paste it into Cherry Studio settings and check

Step 6

Congratulations, the configuration for SiYuan Note is complete ✅ Now you can export content from Cherry Studio to your SiYuan Note

Huawei Cloud

1. Create an account and log in at Huawei Cloud

2. Click this link to enter the MaaS control panel

3. Authorization

1. Click Authentication Management in the sidebar, create an API Key (secret key) and copy it

   Then create a new service provider in CherryStudio

   After creation, enter the secret key

2. Click Model Deployment in the sidebar, claim all offerings
3. Click Call

   Copy the address from ①, paste it into CherryStudio's service provider address field and add a "#" at the end and add a "#" at the end and add a "#" at the end and add a "#" at the end and add a "#" at the end Why add "#"? [see here](https://docs.cherry-ai.com/cherrystudio/preview/settings/providers#api-di-zhi) > You can choose not to read that and just follow this tutorial; > Alternatively, you can fill it by removing v1/chat/completions - feel free to use your own method if you know how, but if not, strictly follow this tutorial.

   Then copy the model name from ②, and click the "+ Add" button in CherryStudio to create a new model

   Enter the model name exactly as shown - do not add or remove anything, and don't include quotes. Copy exactly as in the example.

   Click the Add Model button to complete.

Configuring Dify Knowledge Base

Dify Knowledge Base MCP requires upgrading Cherry Studio to v1.2.9 or higher.

Adding Dify Knowledge Base MCP Server

1. Open Search MCP.

2. Add the dify-knowledge server.

Configuring Dify Knowledge Base

Requires configuring parameters and environment variables

1. Dify Knowledge Base key can be obtained in the following way:

Using Dify Knowledge Base MCP

OneAPI

• Log in and navigate to the tokens page

• Create a new token (you can also directly use the default token ↑)

• Copy the token

• Open CherryStudio's service provider settings and click Add at the bottom of the provider list

• Enter a note name, select OpenAI as the provider, and click OK

• Paste the key you just copied

• Return to the API Key page, copy the root address from the browser's address bar, for example:

• Add models (click Manage to auto-fetch or enter manually) and toggle the switch in the top right corner to start using.

Cherry Studio data backup supports WebDAV for backup. You can choose a suitable WebDAV service for cloud backup.

Based on WebDAV, you can achieve multi-device data synchronization through Computer A WebDAV Computer B.

Example with Jianguoyun (Nutstore)

1. Log in to Jianguoyun, click your username in the top right corner, and select "Account Info":

1. Select "Security Options" and click "Add Application":

1. Enter the application name and generate a random password;

1. Copy and record the password;

1. Get the server address, account, and password;

1. In Cherry Studio Settings -> Data Settings, fill in the WebDAV information;

1. Choose to back up or restore data, and you can set the automatic backup time period.

Knowledge Base Tutorial

In version 0.9.1, Cherry Studio introduces the long-awaited knowledge base feature. Below is the step-by-step guide to using Cherry Studio's knowledge base.

Add Embedding Models

1. Find models in the Model Management Service. You can quickly filter by clicking "Embedding Models".

2. Locate the required model and add it to My Models.

Create Knowledge Base

1. Access: Click the Knowledge Base icon in Cherry Studio's left toolbar to enter the management page.

2. Add Knowledge Base: Click "Add" to start creating.

3. Naming: Enter a name for the knowledge base and add an embedding model (e.g., bge-m3) to complete creation.

Add Files and Vectorize

1. Add Files: Click the "Add Files" button to open file selection.

2. Select Files: Choose supported file formats (pdf, docx, pptx, xlsx, txt, md, mdx, etc.) and open.

3. Vectorization: The system automatically vectorizes files. A green checkmark (✓) indicates completion.

Add Data from Multiple Sources

Cherry Studio supports adding data through:

1. Folder Directories: Entire directories where supported format files are auto-vectorized.

2. URL Links: e.g., https://docs.siliconflow.cn/introduction

3. Sitemaps: XML format sitemaps, e.g., https://docs.siliconflow.cn/sitemap.xml

4. Plain Text Notes: Custom content input.

Search Knowledge Base

After vectorization:

1. Click "Search Knowledge Base" at bottom of page.

2. Enter query content.

3. View search results.

4. Matching scores are displayed per result.

Reference Knowledge Base in Conversations

1. Create new topic > Click "Knowledge Base" in toolbar > Select target knowledge base.

2. Enter question > Model generates answer using retrieved knowledge.

3. Data sources appear below answer for quick reference.

Effective Questioning Methods

Cherry Studio is a free and open-source project. As the project grows, the workload of the team increases significantly. To reduce communication costs and efficiently resolve your issues, we encourage everyone to follow the steps below when reporting problems. This will allow our team to dedicate more time to project maintenance and development. Thank you for your cooperation!

1. Documentation Review and Search

Most basic problems can be resolved by carefully reviewing the documentation:

• Functionality and usage questions can be answered in the documentation;

• High-frequency issues are compiled on the page—check there first for solutions;

• Complex questions can often be resolved through search or using the search bar;

• Carefully read all hint boxes in documents to avoid many common issues;

• Check existing solutions in the GitHub .

2. Web Search or Consult AI

For model-related issues unrelated to client functionality (e.g., model errors, unexpected responses, parameter settings):

• Search online for solutions first;

• Provide error messages to AI assistants for resolution suggestions.

3. Ask in Official Communities or File GitHub Issues

If steps 1-2 don't solve your problem:

• Seek help in our official , , or QQ Group () When reporting:

1. For model errors:

   • Provide full screenshots with error messages visible

   • Include console errors ()

   • Sensitive information can be redacted, but keep model names, parameters, and error details

2. For software bugs:

   • Give detailed error descriptions

   • Provide precise reproduction steps

   • Include OS (Windows/Mac/Linux) and software version number

   • For intermittent issues, describe scenarios and configurations comprehensively

Adding ModelScope MCP Servers

Requires upgrading Cherry Studio to v1.2.9 or higher.

In v1.2.9, Cherry Studio has officially partnered with ModelScope to simplify the process of adding MCP servers, avoiding configuration errors while enabling access to a vast number of MCP servers in the ModelScope community. Follow these steps to synchronize ModelScope's MCP servers in Cherry Studio.

Steps

Access Sync Feature

Go to MCP Server Settings in Settings and select Sync Servers

Discover MCP Services

Select ModelScope and browse available MCP services

View MCP Server Details

Register/login to ModelScope and view MCP service details

Connect Server

In the MCP service details, choose "Connect Service"

Obtain and Apply API Token

Click "Get API" token in Cherry Studio to visit ModelScope's official website, copy the API token, then paste it back in Cherry Studio.

Successful Sync

ModelScope-connected MCP services will appear in Cherry Studio's MCP server list and become available for conversations.

Incremental Updates

For future MCP servers connected via ModelScope website, simply click Sync Servers to add them incrementally.

With these steps, you've mastered how to efficiently synchronize ModelScope's MCP servers in Cherry Studio. The simplified configuration process eliminates manual setup complexities while unlocking access to ModelScope's extensive MCP server resources.

Start exploring these powerful MCP services to enhance your Cherry Studio experience!

Custom Providers

Cherry Studio not only integrates mainstream AI model services but also empowers you with powerful customization capabilities. Through the Custom AI Providers feature, you can easily integrate any AI model you require.

Why Do You Need Custom AI Providers?

• Flexibility: Break free from predefined provider lists and freely choose the AI models that best suit your needs.

• Diversity: Experiment with various AI models from different platforms to discover their unique advantages.

• Controllability: Directly manage your API keys and access addresses to ensure security and privacy.

• Customization: Integrate privately deployed models to meet the demands of specific business scenarios.

How to Add a Custom AI Provider?

Add your custom AI provider to Cherry Studio in just a few simple steps:

1. Open Settings: Click the "Settings" (gear icon) in the left navigation bar of the Cherry Studio interface.

2. Enter Model Services: Select the "Model Services" tab in the settings page.

3. Add Provider: On the "Model Services" page, you'll see existing providers. Click the "+ Add" button below the list to open the "Add Provider" pop-up.

4. Fill in Information: In the pop-up, provide the following details:

   • Provider Name: Give your custom provider a recognizable name (e.g., MyCustomOpenAI).

   • Provider Type: Select your provider type from the dropdown menu. Currently supports:

     • OpenAI

     • Gemini

     • Anthropic

     • Azure OpenAI

5. Save Configuration: After filling in the details, click the "Add" button to save your configuration.

Configuring Custom AI Providers

After adding, locate your newly added provider in the list and configure it:

1. Activation Status: Toggle the activation switch on the far right of the list to enable this custom service.

2. API Key:

   • Enter the API key provided by your AI provider.

   • Click the "Test" button to verify the key's validity.

3. API Address:

   • Enter the base URL to access the AI service.

   • Always refer to your AI provider's official documentation for the correct API address.

4. Model Management:

   • Click the "+ Add" button to manually add model IDs you want to use under this provider (e.g., gpt-3.5-turbo, gemini-pro).

   • If unsure about specific model names, consult your AI provider's official documentation.

   • Click the "Manage" button to edit or delete added models.

Getting Started

After completing the above configurations, you can select your custom AI provider and model in Cherry Studio's chat interface and start conversing with AI!

Using vLLM as a Custom AI Provider

vLLM is a fast and easy-to-use LLM inference library similar to Ollama. Here's how to integrate vLLM into Cherry Studio:

1. Install vLLM: Follow vLLM's official documentation (https://docs.vllm.ai/en/latest/getting_started/quickstart.html) to install vLLM.

   复制

   pip install vllm # if using pip
   uv pip install vllm # if using uv

2. Launch vLLM Service: Start the service using vLLM's OpenAI-compatible interface via two main methods:

   • Using vllm.entrypoints.openai.api_server

   复制

   python -m vllm.entrypoints.openai.api_server --model gpt2

   • Using uvicorn

   复制

   vllm --model gpt2 --served-model-name gpt2

Ensure the service launches successfully, listening on the default port 8000. You can also specify a different port using the --port parameter.

1. Add vLLM Provider in Cherry Studio:

   • Follow the steps above to add a new custom AI provider.

   • Provider Name: vLLM

   • Provider Type: Select OpenAI.

2. Configure vLLM Provider:

   • API Key: Leave this field blank or enter any value since vLLM doesn't require an API key.

   • API Address: Enter vLLM's API address (default: http://localhost:8000/, adjust if using a different port).

   • Model Management: Add the model name loaded in vLLM (e.g., gpt2 for the command python -m vllm.entrypoints.openai.api_server --model gpt2).

3. Start Chatting: Now select the vLLM provider and the gpt2 model in Cherry Studio to chat with the vLLM-powered LLM!

Tips and Tricks

• Read Documentation Carefully: Before adding custom providers, thoroughly review your AI provider's official documentation for API keys, addresses, model names, etc.

• Test API Keys: Use the "Test" button to quickly verify API key validity.

• Verify API Addresses: Different providers and models may have varying API addresses—ensure correctness.

• Add Models Judiciously: Only add models you'll actually use to avoid cluttering.

Ollama

Ollama is an excellent open-source tool that allows you to easily run and manage various large language models (LLMs) locally. Cherry Studio now supports Ollama integration, enabling you to interact directly with locally deployed LLMs through the familiar interface without relying on cloud services!

What is Ollama?

Ollama is a tool that simplifies the deployment and use of large language models (LLMs). It has the following features:

• Local Operation: Models run entirely on your local computer without requiring internet connectivity, protecting your privacy and data security.

• Simple and User-Friendly: Download, run, and manage various LLMs through simple command-line instructions.

• Rich Model Selection: Supports popular open-source models like Llama 2, Deepseek, Mistral, Gemma, and more.

• Cross-Platform: Compatible with macOS, Windows, and Linux systems.

• OpenAPI: Features OpenAI-compatible interfaces for integration with other tools.

Why Use Ollama with Cherry Studio?

• No Cloud Service Needed: Break free from cloud API quotas and fees, and fully leverage the power of local LLMs.

• Data Privacy: All your conversation data remains locally stored with no privacy concerns.

• Offline Availability: Continue interacting with LLMs even without an internet connection.

• Customization: Choose and configure the most suitable LLMs according to your needs.

Configuring Ollama in Cherry Studio

1. Install and Run Ollama

First, you need to install and run Ollama on your computer. Follow these steps:

• Download Ollama: Visit the Ollama official website and download the installation package for your operating system. For Linux systems, you can directly install Ollama by running:

  复制

  curl -fsSL https://ollama.com/install.sh | sh

• Install Ollama: Complete the installation by following the installer instructions.

• Download Models: Open a terminal (or command prompt) and use the ollama run command to download your desired model. For example, to download the Llama 2 model, run:

  复制

  ollama run llama3.2

  Ollama will automatically download and run the model.

• Keep Ollama Running: Ensure Ollama remains running while using Cherry Studio to interact with its models.

2. Add Ollama as a Provider in Cherry Studio

Next, add Ollama as a custom AI provider in Cherry Studio:

• Open Settings: Click on "Settings" (gear icon) in the left navigation bar of Cherry Studio.

• Access Model Services: Select the "Model Services" tab in the settings page.

• Add Provider: Click "Ollama" in the provider list.

3. Configure Ollama Provider

Locate the newly added Ollama provider in the list and configure it in detail:

1. Enable Status:

   • Ensure the switch on the far right of the Ollama provider is turned on (indicating enabled status).

2. API Key:

   • Ollama typically requires no API key. Leave this field blank or enter any content.

3. API Address:

   • Enter Ollama's local API address. Normally, this is:

     复制

     http://localhost:11434/

     Adjust if you've modified the default port.

4. Keep-Alive Time: Sets the session retention time in minutes. Cherry Studio will automatically disconnect from Ollama if no new interactions occur within this period to free up resources.

5. Model Management:

   • Click "+ Add" to manually add the names of models you've downloaded in Ollama.

   • For example, if you downloaded llama3.2 via ollama run llama3.2, enter llama3.2 here.

   • Click "Manage" to edit or delete added models.

Getting Started

After completing the above configurations, select Ollama as the provider and choose your downloaded model in Cherry Studio's chat interface to start conversations with local LLMs!

Tips and Tricks

• First-Time Model Execution: Ollama needs to download model files during initial runs, which may take considerable time. Please be patient.

• View Available Models: Run ollama list in the terminal to see your downloaded Ollama models.

• Hardware Requirements: Running large language models requires substantial computing resources (CPU, RAM, GPU). Ensure your computer meets the model's requirements.

• Ollama Documentation: Click the View Ollama Documentation and Models link in the configuration page to quickly access Ollama's official documentation.

Internet Mode

How to Enable Internet Access

In the Cherry Studio question window, click the 【Globe】 icon to enable internet access.

Important Note: Two Modes for Internet Access

Mode 1: Models with built-in internet function from providers

When using such models, enabling internet access requires no extra steps - it's straightforward.

This method also helps quickly distinguish internet-enabled models in the Model Management page.

Cherry Studio currently supports internet-enabled models from

• Google Gemini

• OpenRouter (all models support internet)

• Tencent Hunyuan

• Zhipu AI

• Alibaba Bailian, etc.

Mode 2: Models without internet function use Tavily service

When using models without built-in internet (no globe icon), use Tavily search service to process real-time information.

First-time Tavily setup triggers a setup prompt - simply follow the instructions!

After clicking, you'll be redirected to Tavily's website to register/login. Create and copy your API key back to Cherry Studio.

Tavily registration reference:

The following interface confirms successful registration.

Test again for results: shows normal internet search with default result count (5).

PS: Please report any issues you encounter.

Display Settings

On this page, you can set the software's color theme, page layout, or use Custom CSS for personalized configurations.

Theme Selection

Here you can set the default interface color mode (Light mode, Dark mode, or Follow System).

Conversation Settings

These settings apply to the layout of the conversation interface.

Conversation Panel Position

Auto-Switch to Conversation

When enabled, clicking an assistant name will automatically switch to the corresponding conversation.

Show Conversation Time

When enabled, displays the conversation creation time below the conversation.

Custom CSS

This setting allows flexible customization of the interface. Refer to the advanced tutorial on Custom CSS for specific methods.

Automatic Installation of MCP

Automatic installation of MCP requires upgrading Cherry Studio to v1.1.18 or higher.

Feature Introduction

In addition to manual installation, Cherry Studio has a built-in @mcpmarket/mcp-auto-install tool that provides a more convenient way to install MCP servers. You simply need to enter specific commands in conversations with large models that support MCP services.

Usage Instructions

For example, you can input:

Help me install a filesystem mcp server

The system will automatically recognize your requirements and complete the installation via @mcpmarket/mcp-auto-install. This tool supports various types of MCP servers, including but not limited to:

• filesystem (file system)

• fetch (network requests)

• sqlite (database)

• etc.

The MCP_PACKAGE_SCOPES variable allows customization of MCP service search sources. Default value: @modelcontextprotocol.

Introduction to the @mcpmarket/mcp-auto-install Library

// `axun-uUpaWEdMEMU8C61K` is the service ID - customizable
"axun-uUpaWEdMEMU8C61K": {
  "name": "mcp-auto-install",
  "description": "Automatically install MCP services (Beta version)",
  "isActive": false,
  "registryUrl": "https://registry.npmmirror.com",
  "command": "npx",
  "args": [
    "-y",
    "@mcpmarket/mcp-auto-install",
    "connect",
    "--json"
  ],
  "env": {
    "MCP_REGISTRY_PATH": "Details at https://www.npmjs.com/package/@mcpmarket/mcp-auto-install"
  },
  "disabledTools": []
}

Obsidian Configuration Tutorial

Cherry Studio supports integration with Obsidian, allowing you to export complete conversations or individual messages to your Obsidian vault.

Latest Tutorial

Step 1: Configure Cherry Studio

Open Cherry Studio's Settings → Data Settings → Obsidian Configuration menu. The drop-down box will automatically display the names of Obsidian vaults that have been opened on this machine. Select your target Obsidian vault:

Step 2: Export Conversations

Exporting a Complete Conversation

Return to Cherry Studio's conversation interface, right-click on the conversation, select Export, and click Export to Obsidian:

A window will pop up allowing you to configure the Properties of the note exported to Obsidian, its folder location, and the processing method:

• Vault: Click the drop-down menu to select another Obsidian vault

• Path: Click the drop-down menu to select the folder for storing the exported conversation note

• As Obsidian note properties:

  • Tags

  • Created time

  • Source

• Three available processing methods:

  • New (overwrite if exists): Create a new conversation note in the folder specified at Path. If a note with the same name exists, it will overwrite the old note

  • Prepend: When a note with the same name already exists, export the selected conversation content and add it to the beginning of that note

  • Append: When a note with the same name already exists, export the selected conversation content and add it to the end of that note

After selecting all options, click OK to export the complete conversation to the specified folder in the corresponding Obsidian vault.

Exporting a Single Message

To export a single message, click the three-dash menu below the message, select Export, and click Export to Obsidian:

The same window as when exporting a complete conversation will appear, requiring you to configure the note properties and processing method. Complete the configuration following the same steps as in .

Successful Export

🎉 Congratulations! You've completed all configurations for Cherry Studio's integration with Obsidian and finished the entire export process. Enjoy yourselves!

Old Tutorial (for Cherry Studio < v1.1.13)

Step 1: Prepare Obsidian

Open your Obsidian vault and create a folder to store exported conversations (shown as "Cherry Studio" folder in the example):

Note the text highlighted in the bottom-left corner - this is your vault name.

Step 2: Configure Cherry Studio

In Cherry Studio's Settings → Data Settings → Obsidian Configuration menu, enter the vault name and folder name obtained in :

Global Tags is optional and can be used to set tags for all exported conversations in Obsidian. Fill in as needed.

Step 3: Export Conversations

Exporting a Complete Conversation

Return to Cherry Studio's conversation interface, right-click on the conversation, select Export, and click Export to Obsidian:

A window will pop up allowing you to adjust the Properties of the note exported to Obsidian and select a processing method. Three processing methods are available:

• New (overwrite if exists): Create a new conversation note in the folder specified in . If a note with the same name exists, it will overwrite the old note

• Prepend: When a note with the same name already exists, export the selected conversation content and add it to the beginning of that note

• Append: When a note with the same name already exists, export the selected conversation content and add it to the end of that note

Exporting a Single Message

To export a single message, click the three-dash menu below the message, select Export, and click Export to Obsidian:

The same window as when exporting a complete conversation will appear. Complete the configuration by following the same steps in .

Successful Export

🎉 Congratulations! You've completed all configurations for Cherry Studio's integration with Obsidian and finished the entire export process. Enjoy yourselves!

Custom CSS

By customizing CSS, you can modify the software's appearance to better suit your preferences, like this:

Built-in Variables

For more theme variables, refer to the source code:

Related Recommendations

Cherry Studio Theme Library:

Share some Chinese-style Cherry Studio theme skins:

Knowledge Popularization

What are Tokens?

Tokens are the basic units of text processed by AI models, understood as the smallest units of model "thinking". They are not entirely equivalent to the characters or words as we understand them, but rather a special way the model segments text itself.

1. Chinese Tokenization

• A Chinese character is typically encoded as 1-2 tokens

• For example: "你好" ≈ 2-4 tokens

2. English Tokenization

• Common words are typically 1 token

• Longer or uncommon words are decomposed into multiple tokens

• For example:

  • "hello" = 1 token

  • "indescribable" = 4 tokens

3. Special Characters

• Spaces, punctuation, etc. also consume tokens

• Line breaks are typically 1 token

What is a Tokenizer?

A Tokenizer is the tool that converts text into tokens for AI models. It determines how to split input text into the smallest units that models can understand.

Why do different models have different Tokenizers?

1. Different Training Data

• Different corpora lead to different optimization directions

• Variations in multilingual support levels

• Specialized optimization for specific domains (medical, legal, etc.)

2. Different Tokenization Algorithms

• BPE (Byte Pair Encoding) - OpenAI GPT series

• WordPiece - Google BERT

• SentencePiece - Suitable for multilingual scenarios

3. Different Optimization Goals

• Some focus on compression efficiency

• Others on semantic preservation

• Others on processing speed

Practical Impact

The same text may have different token counts across models:

What is an Embedding Model?

Basic Concept: An embedding model is a technique that converts high-dimensional discrete data (text, images, etc.) into low-dimensional continuous vectors. This transformation allows machines to better understand and process complex data. Imagine it as simplifying a complex puzzle into a simple coordinate point that still retains the puzzle's key features. In the large model ecosystem, it serves as a "translator," converting human-understandable information into AI-computable numerical forms.

Working Principle: Taking natural language processing as an example, an embedding model maps words to specific positions in vector space. In this space:

• Vectors for "King" and "Queen" will be very close

• Pet-related words like "cat" and "dog" will cluster together

• Semantically unrelated words like "car" and "bread" will be distant

Main Application Scenarios:

• Text analysis: Document classification, sentiment analysis

• Recommendation systems: Personalized content recommendations

• Image processing: Similar image retrieval

• Search engines: Semantic search optimization

Core Advantages:

1. Dimensionality reduction: Simplifies complex data into manageable vector forms

2. Semantic preservation: Retains key semantic information from original data

3. Computational efficiency: Significantly improves training and inference efficiency

Technical Value: Embedding models are fundamental components of modern AI systems, providing high-quality data representations for machine learning tasks, and are key technologies driving advances in natural language processing, computer vision, and other fields.

How Embedding Models Work in Knowledge Retrieval

Basic Workflow:

1. Knowledge Base Preprocessing Stage

   • Split documents into appropriately sized chunks

   • Use embedding models to convert each chunk into vectors

   • Store vectors and original text in a vector database

2. Query Processing Stage

   • Convert user questions into vectors

   • Retrieve similar content from the vector database

   • Provide retrieved context to the LLM

What is MCP (Model Context Protocol)?

MCP is an open-source protocol designed to provide context information to large language models (LLMs) in a standardized way.

• Analogy: Think of MCP as a "USB drive" for AI. Just as USB drives can store various files and be plugged into computers for immediate use, MCP servers can "plug in" various context-providing "plugins". LLMs can request these plugins from MCP servers as needed to obtain richer context information and enhance their capabilities.

• Comparison with Function Tools: Traditional function tools provide external capabilities to LLMs, but MCP is a higher-level abstraction. Function tools focus on specific tasks, while MCP provides a more universal, modular context acquisition mechanism.

Core Advantages of MCP

1. Standardization: Provides unified interfaces and data formats for seamless collaboration between LLMs and context providers.

2. Modularity: Allows developers to decompose context information into independent modules (plugins) for easy management and reuse.

3. Flexibility: Enables LLMs to dynamically select required context plugins for smarter, more personalized interactions.

4. Extensibility: Supports adding new types of context plugins in the future, providing unlimited possibilities for LLM capability expansion.

Network Search Blacklist Configuration

Cherry Studio supports two methods for configuring blacklists: manual setup and adding subscription sources. Configuration rules reference

Manual Configuration

You can add rules to search results or click the toolbar icon to block specified websites. Rules can be specified using: (example: *://*.example.com/*) or (example: /example\.(net|org)/).

Subscription Sources Configuration

You can also subscribe to public rule sets. This website lists some subscriptions: https://iorate.github.io/ublacklist/subscriptions

Here are some recommended subscription source links:

Cherry Studio License Agreement

By using or distributing any portion or element of Cherry Studio materials, you are deemed to have acknowledged and accepted the terms of this Agreement, which shall take effect immediately.

I. Definitions

1. This Cherry Studio License Agreement (hereinafter referred to as the "Agreement") shall mean the terms and conditions governing the use, reproduction, distribution, and modification of the Materials as defined herein.

2. "We" (or "Our") shall mean Shanghai WisdomAI Technology Co., Ltd.

3. "You" (or "Your") shall mean a natural person or legal entity exercising rights granted under this Agreement and/or using the Materials for any purpose and in any field of use.

4. "Third Party" shall mean an individual or legal entity not under common control with Us or You.

5. "Cherry Studio" shall mean this software suite, including but not limited to [e.g., core libraries, editor, plugins, sample projects], as well as source code, documentation, sample code, and other elements of the foregoing distributed by Us. (Please elaborate based on Cherry Studio’s actual composition.)

6. "Materials" shall collectively refer to Cherry Studio and documentation (and any portions thereof), proprietary to Shanghai WisdomAI Technology Co., Ltd., and provided under this Agreement.

7. "Source" Form shall mean the preferred form for making modifications, including but not limited to source code, documentation source files, and configuration files.

8. "Object" Form shall mean any form resulting from mechanical transformation or translation of a Source Form, including but not limited to compiled object code, generated documentation, and forms converted into other media types.

9. "Commercial Use" shall mean use for the purpose of direct or indirect commercial benefit or commercial advantage, including but not limited to sale, licensing, subscription, advertising, marketing, training, consulting services, etc.

10. "Modification" shall mean any change, adaptation, derivation, or secondary development to the Source Form of the Materials, including but not limited to modifying application names, logos, code, features, interfaces, etc.

II. Grant of Rights

1. Free Commercial Use (Limited to Unmodified Code): Subject to the terms and conditions of this Agreement, We hereby grant You a non-exclusive, worldwide, non-transferable, royalty-free license to use, reproduce, distribute, copy, and disseminate unmodified Materials, including for Commercial Use, under the intellectual property or other rights We own or control embodied in the Materials.

2. Commercial Authorization (When Necessary): Under the conditions described in Section III ("Commercial Authorization"), You must obtain explicit written commercial authorization from Us to exercise rights under this Agreement.

III. Commercial Authorization

In any of the following circumstances, You must contact Us and obtain explicit written commercial authorization before continuing to use Cherry Studio Materials:

1. Modification and Derivation: You modify Cherry Studio Materials or develop derivatives based on them (including but not limited to modifying application names, logos, code, features, interfaces, etc.).

2. Enterprise Services: You provide services based on Cherry Studio within Your enterprise or for enterprise clients, and such services support 10 or more cumulative users.

3. Hardware Bundling: You pre-install or integrate Cherry Studio into hardware devices or products for bundled sales.

4. Government or Educational Institutional Procurement: Your use case involves large-scale procurement projects by government or educational institutions, especially those involving sensitive requirements such as security or data privacy.

5. Public Cloud Services: Providing public-facing cloud services based on Cherry Studio.

IV. Redistribution

You may distribute copies of unmodified Materials or make them available as part of a product or service containing unmodified Materials, distributed in Source or Object Form, provided You satisfy the following conditions:

1. You must provide a copy of this Agreement to any other recipient of the Materials;

2. You must retain the following attribution notice in all copies of the Materials You distribute, placing it within a "NOTICE" or similar text file distributed as part of such copies: "Cherry Studio is licensed under the Cherry Studio LICENSE AGREEMENT, Copyright (c) Shanghai WisdomAI Technology Co., Ltd. All Rights Reserved."

V. Usage Rules

1. Materials may be subject to export controls or restrictions. You shall comply with applicable laws and regulations when using the Materials.

2. If You use Materials or any output thereof to create, train, fine-tune, or improve software or models that will be distributed or provided, We encourage You to prominently mark "Built with Cherry Studio" or "Powered by Cherry Studio" in relevant product documentation.

VI. Intellectual Property

1. We retain ownership of all intellectual property rights to the Materials and derivative works made by or for Us. Subject to compliance with the terms and conditions of this Agreement, intellectual property rights in modifications and derivative works of the Materials created by You shall be governed by the specific commercial authorization agreement. Without obtaining commercial authorization, You do not own such modifications or derivatives, and all intellectual property rights therein remain vested in Us.

2. No trademark license is granted for the use of Our trade names, trademarks, service marks, or product names except as necessary to fulfill notice obligations under this Agreement or for reasonable and customary use in describing and redistributing the Materials.

3. If You initiate litigation or other legal proceedings (including counterclaims in litigation) against Us or any entity alleging that the Materials, any output thereof, or any portion thereof infringes any intellectual property or other rights owned or licensable by You, all licenses granted to You under this Agreement shall terminate as of the commencement or filing date of such litigation or proceedings.

VII. Disclaimer and Limitation of Liability

1. We have no obligation to support, update, provide training for, or develop any further versions of Cherry Studio Materials, nor to grant any related licenses.

2. THE MATERIALS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, OR FITNESS FOR A PARTICULAR PURPOSE. WE MAKE NO WARRANTIES AND ASSUME NO LIABILITY REGARDING THE SECURITY OR STABILITY OF THE MATERIALS OR ANY OUTPUT THEREOF.

3. IN NO EVENT SHALL WE BE LIABLE TO YOU FOR ANY DAMAGES ARISING FROM YOUR USE OR INABILITY TO USE THE MATERIALS OR ANY OUTPUT THEREOF, INCLUDING BUT NOT LIMITED TO ANY DIRECT, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED.

4. You shall defend, indemnify, and hold Us harmless from any claims by third parties arising from or related to Your use or distribution of the Materials.

VIII. Duration and Termination

1. The term of this Agreement shall begin upon Your acceptance hereof or access to the Materials and shall continue until terminated in accordance with these terms and conditions.

2. We may terminate this Agreement if You breach any term or condition herein. Upon termination, You must cease all use of the Materials. Sections VII, IX, and "II. Contributor Agreement" shall survive termination.

IX. Governing Law and Jurisdiction

1. This Agreement and any disputes arising out of or in connection herewith shall be governed by the laws of China.

2. The People's Court of Shanghai shall have exclusive jurisdiction over any disputes arising from this Agreement.

Default Storage Location

Cherry Studio data storage follows system specifications. Data is automatically placed in the user directory at the following locations:

macOS: /Users/username/Library/Application Support/CherryStudioDev

Windows: C:\Users\username\AppData\Roaming\CherryStudio

Linux: /home/username/.config/CherryStudio

You can also view it at:

Changing Storage Location (For Reference)

Method 1:

This can be achieved by creating a symbolic link. Exit the application, move the data to your desired location, then create a link at the original location pointing to the new path.

For detailed steps, refer to: https://github.com/CherryHQ/cherry-studio/issues/621#issuecomment-2588652880

Method 2: Based on Electron application characteristics, modify the storage location by configuring launch parameters.

--user-data-dir Example: Cherry-Studio-*-x64-portable.exe --user-data-dir="%user_data_dir%"

Example:

PS D:\CherryStudio> dir


    目录: D:\CherryStudio


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2025/4/18     14:05                user-data-dir
-a----         2025/4/14     23:05       94987175 Cherry-Studio-1.2.4-x64-portable.exe
-a----         2025/4/18     14:05            701 init_cherry_studio.bat

init_cherry_studio.bat (encoding: ANSI)

@title CherryStudio Initialization
@echo off

set current_path_dir=%~dp0
@echo Current path: %current_path_dir%
set user_data_dir=%current_path_dir%user-data-dir
@echo CherryStudio data path: %user_data_dir%

@echo Searching for Cherry-Studio-*-portable.exe in current directory
setlocal enabledelayedexpansion

for /f "delims=" %%F in ('dir /b /a-d "Cherry-Studio-*-portable*.exe" 2^>nul') do ( # Compatible with GitHub and official releases. Modify for other versions
    set "target_file=!cd!\%%F"
    goto :break
)
:break
if defined target_file (
    echo Found file: %target_file%
) else (
    echo No matching files found. Exiting script
    pause
    exit
)

@echo Press any key to continue...
pause

@echo Launching CherryStudio
start %target_file% --user-data-dir="%user_data_dir%"

@echo Operation completed
@echo on
exit

Initial structure of user-data-dir:

PS D:\CherryStudio> dir .\user-data-dir\


    目录: D:\CherryStudio\user-data-dir


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2025/4/18     14:29                blob_storage
d-----         2025/4/18     14:07                Cache
d-----         2025/4/18     14:07                Code Cache
d-----         2025/4/18     14:07                Data
d-----         2025/4/18     14:07                DawnGraphiteCache
d-----         2025/4/18     14:07                DawnWebGPUCache
d-----         2025/4/18     14:07                Dictionaries
d-----         2025/4/18     14:07                GPUCache
d-----         2025/4/18     14:07                IndexedDB
d-----         2025/4/18     14:07                Local Storage
d-----         2025/4/18     14:07                logs
d-----         2025/4/18     14:30                Network
d-----         2025/4/18     14:07                Partitions
d-----         2025/4/18     14:29                Session Storage
d-----         2025/4/18     14:07                Shared Dictionary
d-----         2025/4/18     14:07                WebStorage
-a----         2025/4/18     14:07             36 .updaterId
-a----         2025/4/18     14:29             20 config.json
-a----         2025/4/18     14:07            434 Local State
-a----         2025/4/18     14:29             57 Preferences
-a----         2025/4/18     14:09           4096 SharedStorage
-a----         2025/4/18     14:30            140 window-state.json

Frequently Asked Questions

Common Error Codes

• 4xx (Client Error Status Codes): Generally indicate requests that cannot be completed due to syntax errors, authentication/authorization failures, etc.

• 5xx (Server Error Status Codes): Generally indicate server-side errors like server downtime, request timeouts, etc.