> ## 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.

# Google Gemini

> Use Google Gemini API models directly through an AI Studio key.

Google Gemini provides direct API access to Gemini models. Use it when you want
Google-managed inference without routing through another gateway.

## Get an API key

Create a key in [Google AI Studio](https://aistudio.google.com/app/apikey). The
key's Google Cloud project must have the Gemini API available and any required
billing configured.

## Configuration

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

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

Roomote adds recommended Gemini models under the `google/` prefix. A practical
mapping uses a Pro model for coding and planning and a Flash model for helper
and explore work. Refresh model metadata after Google changes preview model IDs.

## Cost behavior

Google applies model-specific input, output, caching, and context pricing. Some
projects may have free-tier quotas, but production workloads should not assume
free capacity. Roomote records usage and estimates model cost; Google Cloud
billing and [Gemini API pricing](https://ai.google.dev/gemini-api/docs/pricing)
remain authoritative.

## Verify setup

1. save `GEMINI_API_KEY`
2. confirm Gemini models appear in **Settings > Models**
3. enable a model and assign it to the coding or another role
4. run a small task and confirm usage reaches the key's Google Cloud project

## Common issues

* **The key is rejected.** Confirm it came from AI Studio and that the Gemini
  API is available in the associated project.
* **A preview model stops resolving.** Refresh model metadata and select its
  current replacement; Google periodically retires preview IDs.
* **Quota errors occur.** Check project quota and billing in Google AI Studio or
  Google Cloud, then reduce concurrency or request more quota.