> For the complete documentation index, see [llms.txt](https://llm.theparley.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://llm.theparley.org/choose-your-app/quickstart.md).

# Cherry Studio

There are numerous ways to make use of your Parley credentials. This guide will show you one of the easiest ways to get started with multiple types of functionality, using a laptop or desktop in the operating system of your choosing. 

{% embed url="<https://youtu.be/qcIBNH0PtRs>" %}

{% stepper %}
{% step %}

## Install Cherry Studio

The highlighted options are the most likely matches for your work computer. Note: If you have an older Mac with an Intel processor, select the x64 version. Linux packages are available, too. These versions change as the software is updated, so you may need to locate these extensions on the latest release.\
\
**Official Cherry AI Website:**\
<https://www.cherry-ai.com/>\
\
**Page with the latest releases:**\
<https://github.com/CherryHQ/cherry-studio/releases><br>

* Example Windows Installer Packages (x64-setup.exe)

  Look for something like <https://github.com/CherryHQ/cherry-studio/releases/download/v1.7.2/Cherry-Studio-1.7.2-x64-setup.exe>
* Example macOS Installer Packages (arm64.dmg)

  Look for something like <https://github.com/CherryHQ/cherry-studio/releases/download/v1.7.2/Cherry-Studio-1.7.2-arm64.dmg>
  {% endstep %}

{% step %}

## Open the Settings Menu

Use the settings gear icon to enter the configuration screen.

<figure><img src="/files/BFOcdntRiwGHqdwGPz00" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Open the Model Provider Menu

In the top of the left rail, select the Model Provider tab.
{% endstep %}

{% step %}

## Remove CherryIN Provider

By default, this app includes a provider that is not part of the Parley service. Please disable CherryIN by turning off the green switch in the top right of the settings screen.

<figure><img src="/files/sFwh2z5hHIK9RGCqkRR9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Add a Model Provider

In the bottom of the second column, click the + Add button.&#x20;

<figure><img src="/files/MVc9dmKo40wVRZ2kFuAe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Insert Parley API Key

Now it is time to paste the key you collected from <https://keys.theparley.org/> into the API Key form.

<figure><img src="/files/4KEd3vxqmzeiDHcLHfAJ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Insert Parley API Host

Enter the host URL in the API Host form **precisely** as follows.

```
https://keys.theparley.org/v1
```

{% endstep %}

{% step %}

### Add Models From the List

Under the *Models* header, select *Add*. This will load the models active on the key. Find models such as *gpt-5.2* and *gpt-image-1* in the list.

<figure><img src="/files/yrNO1xcF9ltkoh80DLqO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/YpsAvpXXOgcABegwAB7s" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Confirm GPT-5.2 is Functioning

Select the *Check* button in the API Key area, select *gpt-5.2* and select *OK.* You will see the green check and "Connection Successful" message if all works well.

<figure><img src="/files/Ish0WYYPO1RP8fvMcEiT" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Set GPT-5.2 as the Default

Open the Default Model menu from the left rail and ensure that gpt-5 is the default for all.

<figure><img src="/files/O3mL6N8doebnRoTZdfpR" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Chat with Parley

Select the *Home* button and start conversing with the model *gpt-5.2.*

<figure><img src="/files/Pv28TL7SGhuVL63BJcHg" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Create Images with Parley

Select a diffusion model (e.g., *gpt-image-1*) in a new chat. Prompts create images.

<div><figure><img src="/files/44zdLU370eSuthHttrwI" alt=""><figcaption></figcaption></figure> <figure><img src="/files/qorsY0Kt6kcquHa2XSwE" alt=""><figcaption></figcaption></figure> <figure><img src="/files/zOilhx3ZmMqYVdcKHaAA" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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://llm.theparley.org/choose-your-app/quickstart.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.