> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiandgpu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio 

> Learn how to configure and use Cherry Studio with AI&GPU API

## What is Cherry Studio?

Cherry Studio is a cross-platform AI chat client for Windows, macOS, and Linux. It unifies 300+ mainstream models—including cloud providers such as OpenAI, Claude, and Gemini—and also supports local deployments via Ollama and LM Studio. Beyond conversational assistance, Cherry Studio offers powerful Agent capabilities that can reason, plan, and act autonomously. Give an Agent a goal and it will break down tasks, call tools, and execute steps while you retain full control.

## Features

<CardGroup cols={2}>
  <Card title="Seamless Model Switching" color="#2563EB" icon="robot">
    Swap between OpenAI, Claude, Gemini, and local Ollama/LM Studio models with context preserved so conversations stay uninterrupted.
  </Card>

  <Card title="300+ Smart Assistants" color="#9333EA" icon="users">
    Access a library of 300+ preset expert personas for writing, coding, translation, study guidance, and more.
  </Card>

  <Card title="Intelligent Document Handling" color="#0EA5E9" icon="file-text">
    Drag-and-drop PDFs, Markdown files, or slides and let AI extract structure, key concepts, and answers in seconds.
  </Card>

  <Card title="Productivity Integrations" color="#F97316" icon="sparkles">
    Integrate to-do lists, reminders, knowledge bases, and code snippets so Agents can automate workflows end-to-end.
  </Card>

  <Card title="Personalized Experience" color="#16A34A" icon="sliders">
    Customize system prompts, memory, plugins, and UI themes to match team processes or personal preferences.
  </Card>

  <Card title="Robust Extensibility" color="#DC2626" icon="puzzle">
    Connect proprietary data sources or workflows through the plugin marketplace and open API so Agents can call databases or web services.
  </Card>
</CardGroup>

## Step 1: Installation

Download Cherry Studio: [https://www.cherry-ai.com/download](https://www.cherry-ai.com/download)

## Step 2: Add AGCloud Provider Configuration

### 2.1 Configure OpenAI and Google Providers

Some Claude models do not support the OpenAI-compatible format, so keep them on the dedicated Anthropic connector described in section 2.2. For OpenAI-compatible providers, follow the steps below.

**2.1.1 Open Provider Settings**

<img src="https://mintcdn.com/yvshun-470c5ffb/NXOChh5JbOgOm3AL/images/cherry-studio/step-1.png?fit=max&auto=format&n=NXOChh5JbOgOm3AL&q=85&s=9d550248d743f3188074fceec53eba5d" alt="" style={{ height: "auto", width: "100%" }} width="2488" height="1650" data-path="images/cherry-studio/step-1.png" />

**2.1.2 Add the Provider**

<img src="https://mintcdn.com/yvshun-470c5ffb/1QHCeEmGE_jnI8SQ/images/cherry-studio/step-2.png?fit=max&auto=format&n=1QHCeEmGE_jnI8SQ&q=85&s=df220a65d0141b6fafd96c29f17c8e83" alt="" style={{ height: "auto", width: "70%"}} width="1340" height="1016" data-path="images/cherry-studio/step-2.png" />

* Press the **＋** button, give the connector a name such as “AGCloud OpenAI,” and paste your AGCloud API key. Confirm the default base URL if prompted.

**2.1.3 Add the Model ID**

<img src="https://mintcdn.com/yvshun-470c5ffb/1QHCeEmGE_jnI8SQ/images/cherry-studio/step-3.png?fit=max&auto=format&n=1QHCeEmGE_jnI8SQ&q=85&s=27f01841b8904cdd0beb312037a5a3c9" alt="" style={{ height: "auto", width: "70%"}} width="1348" height="834" data-path="images/cherry-studio/step-3.png" />

* In **Model Management → Add Model**, enter the exact model identifier published by AGCloud (for example `gpt-5-chat-latest`) and click **Save**.

### 2.2 Configure Anthropic Provider

Aside from the initial provider creation, the remaining steps match section 2.1.

<img src="https://mintcdn.com/yvshun-470c5ffb/NXOChh5JbOgOm3AL/images/cherry-studio/claude.png?fit=max&auto=format&n=NXOChh5JbOgOm3AL&q=85&s=a1f20e53894f0ed6976b62a6988f1ed7" alt="" style={{ height: "auto", width: "100%" }} width="2488" height="1654" data-path="images/cherry-studio/claude.png" />

<Tip>You can view all available models at: [https://aiandgpu.com/v1/models](https://aiandgpu.com/v1/models) to specify an existing model.</Tip>

## Step 3: Start Chat

* Click the chat icon in the left navigation, pick a model from the dropdown, and type your first prompt.

<img src="https://mintcdn.com/yvshun-470c5ffb/1QHCeEmGE_jnI8SQ/images/cherry-studio/step-4.png?fit=max&auto=format&n=1QHCeEmGE_jnI8SQ&q=85&s=4fb234fe1b4e566cedebddc2b963990c" alt="" style={{ height: "auto", width: "100%" }} width="2488" height="1810" data-path="images/cherry-studio/step-4.png" />

## Step 4: Advanced Configurations

**For advanced model configuration, please refer to the request parameters in the documentation:**

* [**OpenAI reference**](https://docs.aiandgpu.com/api-reference/openAI/gpt-5-chat-latest/official/chat#generation-parameters)
* [**Gemini reference**](https://docs.aiandgpu.com/api-reference/gemini/gemini-3.1-pro-preview/official/chat#generation-configuration-structure)
* [**Claude reference**](https://docs.aiandgpu.com/api-reference/claude/claude-opus-4-6/official/text-to-text#parameters)

<img src="https://mintcdn.com/yvshun-470c5ffb/2qoY2elP_AM7zscT/images/cherry-studio/tutorial-4.png?fit=max&auto=format&n=2qoY2elP_AM7zscT&q=85&s=cc40bb0793c872872ca764b69d87c7c4" alt="" style={{ height: "auto", width: "100%" }} width="1598" height="1120" data-path="images/cherry-studio/tutorial-4.png" />

<img src="https://mintcdn.com/yvshun-470c5ffb/2qoY2elP_AM7zscT/images/cherry-studio/tutorial-5.png?fit=max&auto=format&n=2qoY2elP_AM7zscT&q=85&s=ab91c9c228bccabff8c3b6f50a2a21b8" alt="" style={{ height: "auto", width: "100%" }} width="1566" height="1278" data-path="images/cherry-studio/tutorial-5.png" />

<Warning>
  Some models may not support the `Top-P` and `temperature` parameters. Please disable them if not supported.
</Warning>

## Default Model Configuration

<img src="https://mintcdn.com/yvshun-470c5ffb/1QHCeEmGE_jnI8SQ/images/cherry-studio/step-5.png?fit=max&auto=format&n=1QHCeEmGE_jnI8SQ&q=85&s=79673f8eb8cc08b53da62bc6687d2951" alt="" style={{ height: "auto", width: "100%" }} width="1652" height="890" data-path="images/cherry-studio/step-5.png" />
