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

# Mini Apps

\[Mini apps] Let web services and locally installed widgets run in Cherry Studio. In addition to opening the web versions of various AI vendors, you can also install custom generative mini apps so they can call the AI models configured in Cherry Studio through authorized APIs.

### First, distinguish between the two types of mini apps

| Type           | How to add                                                                  | Can it call Cherry AI                       | Suitable scenarios                                                                            |
| -------------- | --------------------------------------------------------------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Website        | Enter the name, URL, and logo                                               | No                                          | Pin commonly used websites to Cherry Studio while keeping each site’s own login status        |
| Local mini app | Install `.miniapp` package, or install from a URL provided by the developer | Yes, with authorization during installation | Custom AI writing, summarization, translation, information extraction, and vertical workflows |

{% hint style="info" %}
If you want to create a “custom mini app that can call Cherry AI,” use a \[Local mini app] instead of a \[Website] that only fills in a URL. See the complete tutorial in [generative mini app](/docs/en-us/cherry-studio/preview/app/generative-mini-apps.md).
{% endhint %}

### Enter the mini app

{% stepper %}
{% step %}

### Open the launcher

Click the `+`tab bar at the top, or open the \[Launcher] directly.
{% endstep %}

{% step %}

### Enter the mini app

Click the \[Mini Apps] app icon.
{% endstep %}

{% step %}

### Select a service

Select the service you want to open in the mini app grid.
{% endstep %}
{% endstepper %}

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-f2b42c0e0ef79d029f9c59adf8b2e7d6cde79da8%2Fapp-grid.png?alt=media" alt=""><figcaption><p>Mini app grid, with dozens of built-in services; click the <code>+</code> to add any web page</p></figcaption></figure>

There is a **search box**in the middle of the page; the top right `+` is used to add custom web pages,`☰` Open \[Mini App Display Settings].

### Settings

In \[Settings] → \[Mini Apps], you can make the following adjustments to mini apps:

* **Show / hide mini apps**: Drag mini apps left or right between the two areas to control visibility
* **Sort mini apps**: Drag up or down to sort mini apps
* **Mini app area filtering**: Automatically hide mini apps you cannot access based on your selection
* **Mini app cache count**: If the number of mini apps open at the same time exceeds this count, some mini apps will become inactive

### Add and manage

Cherry Studio’s mini apps support the following operations:

* **Add to launcher**: Add frequently used mini apps to the launcher for convenient access from the `+` entry. You can manage this in \[Settings] → \[Mini Apps], or right-click the mini app icon and choose **Add to launcher**
* **Add to sidebar**: Pin frequently used mini apps to the left sidebar for one-click access; right-click the mini app icon and choose **Add to sidebar** or **Remove from sidebar**
* **Keep Alive**: Keep the mini app window from being destroyed immediately when you switch away, so when you return you do not need to log in or reload again
* **Add website**: Click the `+`in the upper-right corner of the page, and fill in the name, URL, and logo under \[Website] to add it to the grid
* **Install a local mini app**: Click the `+`, switch to \[Local mini app], select the `.miniapp` package, or enter the installation URL provided by the developer. Complete the installation after confirming permissions
* **View local mini app details**: Right-click a local mini app and choose \[View details] to manage permissions, AI models, storage space, activity logs, and updates
* **Delete / Edit**: Website mini apps can be edited or deleted by right-clicking; local mini apps can be uninstalled in \[View details]

After opening a mini app, its window comes with a toolbar:**Back**、**Forward**、**Refresh**、**Open in browser**. You can also switch whether in-page links open in the default window or in the system browser.

<figure><img src="https://1658303467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-798d18297be71f044e3e3662f05a1fc1ba09294a%2Fapp-popup-toolbar.png?alt=media" alt=""><figcaption><p>Mini app window toolbar: back / forward / refresh on the left, open in browser, add to launcher, and in-page link opening mode on the right</p></figcaption></figure>

### Tips and tricks

* Website mini apps use the service’s web version; login state, cookies, and settings are all stored locally and isolated from the system browser
* Local mini apps run in an independent sandbox and cannot read files from other mini apps or any file on the computer; only the capabilities you authorize can be called
* If a mini app fails to load, right-click → Refresh, or check the proxy settings (see [General settings](/docs/en-us/pre-basic/settings/general.md))

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>generative mini app</strong></td><td>Create, install, and manage custom mini apps that can call Cherry AI</td><td><a href="/docs/en-us/cherry-studio/preview/app/generative-mini-apps.md">Generative Mini Apps</a></td></tr></tbody></table>

If you encounter any issues, please submit feedback in [Feedback and suggestions](/docs/en-us/question-contact/suggestions.md) .

***

### Get help and submit feedback

If you have any questions, bugs, or feature improvement suggestions during configuration or use, please refer to the official channels provided in [Feedback and suggestions](/docs/en-us/question-contact/suggestions.md) .&#x20;


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/en-us/cherry-studio/preview/app.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.