# Integrate with CherryStudio

CherryStudio integrates with MaaS-Base to leverage locally hosted LLMs, embeddings and reranking capabilities.

## Deploying Models

1. In MaaS-Base UI, navigate to the `Deployments` page and click on `Deploy Model` to deploy the models you need. Here are some example models:

    - qwen3-instruct-2507
    - qwen2.5-vl-7b
    - bge-m3
    - bge-reranker-v2-m3

   ![GPUStack models](../assets/integrations/integration-gpustack-models2.png)

2. In the model’s Operations, open `API Access Info` to see how to integrate with this model:

   ![API Access Info](../assets/integrations/integration-gpustack-api-access-info2.png)

## Create an API Key

1. Hover over the user avatar and navigate to the `API Keys` page, then click on `New API Key`.

2. Fill in the name, then click `Save`.

3. Copy the API key and save it for later use.

## Integrating MaaS-Base into CherryStudio

1. Open CherryStudio, go to `Settings` → `Model Provider`, find MaaS-Base, enable it, and configure it as shown:

    - `API Key`: Input the API key you copied from previous steps.

    - `API Host`: `Access URL` in the `API Access Info` panel.

   ![CherryStudio GPUStack setup](../assets/integrations/integration-cherrystudio-01.png)

2. In the GPUStack provider configuration, click "Manage" and enable the models you need:

   ![Manage models](../assets/integrations/integration-cherrystudio-02.png)

   ![Enable models](../assets/integrations/integration-cherrystudio-03.png)

3. (Optional) Test the API:

   ![Test API](../assets/integrations/integration-cherrystudio-04.png)

After configuration, return to the CherryStudio home page and start using your models.

## Using LLMs

![Use LLMs](../assets/integrations/integration-cherrystudio-05.png)

## Using Multimodal Models

1. Select a multimodal model:

   ![Select multimodal model](../assets/integrations/integration-cherrystudio-13.png)

2. Ask multimodal questions:

   ![Multimodal Q&A](../assets/integrations/integration-cherrystudio-14.png)

   ![Multimodal Q&A](../assets/integrations/integration-cherrystudio-15.png)

## Use Embeddings and Reranking to Improve Knowledge Base Q&A

1. Open the Knowledge Base configuration page:

   ![KB settings](../assets/integrations/integration-cherrystudio-06.png)

2. Add a knowledge base:

   ![Add KB](../assets/integrations/integration-cherrystudio-08.png)

3. Add content to the knowledge base (using “Notes” as an example):

   ![Add KB content](../assets/integrations/integration-cherrystudio-09.png)

   ![KB content details](../assets/integrations/integration-cherrystudio-10.png)

4. Return to the home page and use knowledge base Q&A:

   ![KB Q&A](../assets/integrations/integration-cherrystudio-11.png)

   ![KB Q&A example](../assets/integrations/integration-cherrystudio-12.png)
