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

# Cherry Studio

> Chat with RedPill models in the Cherry Studio desktop app

Cherry Studio is a desktop client for Windows, macOS, and Linux. Add RedPill as a custom
OpenAI-compatible provider to use its live model catalog.

Download the current release from [Cherry Studio on GitHub](https://github.com/CherryHQ/cherry-studio/releases).

## Add RedPill

Open **Settings**, select **Model Services**, and add a custom provider with these values:

| Field         | Value                       |
| ------------- | --------------------------- |
| Provider name | `RedPill AI`                |
| Provider type | **OpenAI**                  |
| API address   | `https://api.redpill.ai/v1` |
| API key       | Your RedPill API key        |

Use the base URL ending in `/v1`; Cherry Studio appends the Chat Completions path. Select **Test**
to verify the key and endpoint.

## Add models

Open **Manage** for the new provider and refresh the model list. If discovery is unavailable, add an
exact ID from the live catalog:

```bash theme={null}
curl -s https://api.redpill.ai/v1/models \
  | jq -r '.data[] | [.id, .is_tee, (.supported_features | join(","))] | @tsv'
```

Choose a model that declares the capabilities you plan to use. Image upload requires `image` in
`input_modalities`; tool-based assistants require `tools` in `supported_features`.

## Privacy choice

Every request enters RedPill through the attested gateway. The selected model's `is_tee` field and
the response [receipt](/confidential-ai/receipts) describe the upstream privacy boundary.

To make the provider reject standard models, use `https://tee.redpill.ai/v1` as the API address and
enable only current `is_tee: true` models. Cherry Studio may not expose RedPill's `x-receipt-id`
response header; use a direct API client when receipt verification is required.

## Troubleshooting

| Symptom               | Check                                                                    |
| --------------------- | ------------------------------------------------------------------------ |
| Connection test fails | Confirm the API address ends in `/v1` and re-enter the RedPill key.      |
| Models do not load    | Refresh **Manage** or add a full model ID from `GET /v1/models`.         |
| A model returns `404` | Refresh the catalog; model availability changes over time.               |
| Images or tools fail  | Check the model's declared modalities and features before enabling them. |

## References

* [Cherry Studio documentation](https://docs.cherry-ai.com/)
* [Cherry Studio releases](https://github.com/CherryHQ/cherry-studio/releases)
* [RedPill model catalog](/get-started/models)
