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

# Choose models and apps

> Pick which image, video and audio models and which creative apps Voyager uses for a chat, a project or every project.

Voyager picks a model for each image, video or sound it makes, and an app for each kind of job, such as motion graphics or video editing. When you have a favorite, set it once and Voyager uses it whenever a chat doesn't name one.

> [!NOTE]
>
> **Before you start:** you don't have to choose anything. Every choice starts on **Auto**: Voyager picks, using your subscriptions before credits. A model you choose still needs a provider that can run it; see [Choose your generation providers](https://docs.voyager.so/account/generation-providers.md).

## Choose for a chat

**1. Open Preferred models and apps**

In the message box, click the button just before the agent model picker (its tooltip reads **Preferred creative apps and media models**). It shows small media icons while everything is on **Auto**, and the marks of your choices once you set some.

**2. Pick a model or app**

Under **Models**, click a kind: **Image**, **Image edit**, **Video**, **Voice**, **Music**, **Sound effects** or **3D**. Under **Apps**, click a job: **Motion graphics**, **Video editing**, **Design**, **Slides**, **3D**, **Music** or **Games**. Search the list and choose one. Anything you leave alone stays on **Auto**.

**3. Keep it for the project, if you like**

Changes apply to this chat and your next new chat. To make them the project's default, click **Save as … default** (it shows your project's name).

![The Preferred models and apps panel above the message box, with Models and Apps columns, rows set to Auto, a Choices for menu set to This chat, Reset, Save as project default and Manage in Apps & Models.](https://mintcdn.com/voyager/193F9fREXJhp2PWx/images/screenshots/composer-preferences-panel.light.png?fit=max\&auto=format\&n=193F9fREXJhp2PWx\&q=85\&s=899b5be91182c206bd5be22e8d9c5cf9)

Preferred models and apps: one row per kind of model and per kind of app, with the scope at the top.

## Choose for a project or every project

Use the menu at the top of the panel to change whose choices you're editing:

| Choice | What it changes |
| - | - |
| **This chat** | This chat, and the starting choices for your new chats. |
| **This project** | The project's default, used by new chats in this project. Shown when the chat is in a project. |
| **All projects** | The default for every project that doesn't set its own. |

Each chat keeps its own copy of the choices it started with, so changing a project's or the All projects defaults affects new chats, not ones you already have.

**Reset** goes back one level: a chat goes back to its project's choices, a project to the All projects settings, and All projects to **Auto** everywhere.

You can name a model or app in your message at any time. That wins for that request.

## Manage them in Apps & Models

Click **Manage in Apps & Models**, or open **Apps & Models** in the sidebar:

* **Apps & Models → Models → Default models**: the model Voyager uses when a chat doesn't name one, for **All projects** or a single project.
* **Apps & Models → Apps → Preferred apps**: the app new chats start with, with the same scope choice.

![The Apps & Models page on the Models tab, with the Default models popup open showing a row per kind of model, a scope menu set to All projects and Reset.](https://mintcdn.com/voyager/193F9fREXJhp2PWx/images/screenshots/guides-connectors-preferred-models.light.png?fit=max\&auto=format\&n=193F9fREXJhp2PWx\&q=85\&s=f8bbfa9b856206e414ed55db51e547ce)

Apps & Models → Models, with Default models open.

To try a model on its own before you ask for it in a chat, click **Try** on its row in **Apps & Models → Models**, or **Open playground** at the top of the tab. See [Model playground](https://docs.voyager.so/guides/model-playground.md).

## Check the result

The button in the message box shows the marks of the models and apps you chose. In the panel, a row changed only in this chat reads **Changed in this chat**, and a row that comes from the project reads **… default** with the project's name.

## Common problems

> [accordion] A model says “Connect … to use” or “Sign in to … to use”
>
> No provider you've set up can run that model yet. Connect or sign in to the provider in **Apps & Models → Providers**, or leave the row on **Auto**.

> [accordion] An app says “Install … to use”
>
> The app isn't on this computer. Install it, or choose another app or **Auto**.

> [accordion] A changed default didn't reach my chat
>
> A new chat starts from your latest chat choices, or from its project's or the All projects defaults if you haven't made any. Changing a default doesn't change chats that already exist. To change an existing chat, set it under **This chat** or click **Reset**.

## Related

* [Model playground](https://docs.voyager.so/guides/model-playground.md): run an image, video, voice, music, sound or 3D model directly.
* [Choose your generation providers](https://docs.voyager.so/account/generation-providers.md): which provider Voyager tries first and what happens when one can't finish.
* [Write a useful request](https://docs.voyager.so/guides/write-a-request.md)
* [Connect your creative apps](https://docs.voyager.so/setup/creative-apps.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.