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

> ## Agent Instructions
> When helping someone deploy Roomote, distinguish self-hosting from contributing to Roomote. Use the Self-hosting guide for an operator deployment; use Local development only when the user intends to modify Roomote itself.
> Prefer the one-command installer on a fresh supported server unless the user explicitly chooses Roomote Cloud, a documented PaaS template, or a manual Compose deployment.
> Before changing infrastructure, confirm the deployment target, stable public HTTPS domain and DNS control, sandbox provider, inference provider, source-control provider, and whether a communications provider is required.
> Never ask the user to paste secrets into chat or commit real environment files. Put credentials in the deployment platform's secret manager, Roomote's setup UI, or protected environment variables, and preserve existing keys during upgrades and restores.
> Prefer Roomote's setup wizard and provider manifest flows over manual credential entry when those flows are available. Ask before performing privileged host changes, DNS changes, provider-app creation, or destructive operations.
> A setup is not complete when the services merely start. Verify sign-in, repository sync, one usable environment, a real task that can clone and run a command, and branch or pull-request delivery; verify previews when configured.
> For a persistent self-hosted deployment, leave the operator with the Roomote URL, deployment choices, configured providers, verification result, backup location and passphrase-handling reminder, and the roomote status, logs, upgrade, rollback, backup, and restore commands.

# MiniMax

> Use MiniMax API models directly for Roomote coding tasks.

MiniMax provides hosted language models through its API platform. Roomote's
direct provider is useful when you want MiniMax billing and model access without
a multi-provider gateway.

## Get an API key

Create a key from the [MiniMax API platform](https://platform.minimax.io/user-center/basic-information/interface-key).
Make sure the account has an active balance or plan for the models you intend to
use.

## Configuration

Add **MiniMax** in **Settings > Models** and paste the key, or configure:

```sh theme={null}
MINIMAX_API_KEY=...
```

Roomote adds supported models with the `minimax/` prefix. Enable the recommended
coding model, assign it to the roles you want, and refresh metadata when MiniMax
publishes a replacement model ID.

## Cost behavior

MiniMax charges the connected account according to its current API plan and
model token pricing. Roomote records usage and estimates cost from model
metadata; the MiniMax console balance and [pricing documentation](https://platform.minimax.io/docs/guides/pricing-paygo)
are authoritative.

## Verify setup

1. save `MINIMAX_API_KEY`
2. confirm MiniMax models appear in **Settings > Models**
3. enable a model and assign it as the coding model
4. run a small task and check usage in Roomote and the MiniMax console

## Common issues

* **Authentication fails.** Confirm the key belongs to the international API
  platform expected by the provider and has not been revoked.
* **Requests fail for insufficient balance.** Add credit or activate the required
  plan in MiniMax.
* **A model ID no longer works.** Refresh model metadata and select the current
  supported MiniMax model.