# Gemini CLI

> Install Gemini CLI and point it at Relayvia.

> **Note** This feature is not available yet. The content below describes how it will work at launch.

Gemini CLI uses the native Gemini format.

## Install

Install it with npm; it needs a recent Node.js.

```bash
npm install -g @google/gemini-cli
```

## Config file

Add this to ~/.gemini/.env; Gemini CLI loads it on startup.

```dotenv
GOOGLE_GEMINI_BASE_URL=https://api.relayvia.dev
GEMINI_API_KEY=sk-...
```

Replace `sk-...` with an API key from the console.

## Environment variables

Or set the environment variables in a terminal before starting Gemini CLI.

```bash
export GOOGLE_GEMINI_BASE_URL=https://api.relayvia.dev
export GEMINI_API_KEY=sk-...
gemini
```

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| 401 invalid_api_key | Wrong, disabled or expired API key | Check the key's status in the console and copy the full string starting with `sk-`; create a new key if needed. |
| 402 insufficient_quota | The account's credits, the key's limit or the team member's limit is used up, or the account is frozen | Top up, or ask an admin to raise the limit. Retrying will not help. |
| 403 forbidden | The key may not use the model, the source IP is not on the allowlist, or the account is disabled | Check the key's allowed models and IP allowlist; use official model names as listed by `/v1/models`. |
| 429 rate_limited | Too many requests | Wait for `Retry-After` and retry; contact us if you regularly need more. |
| Cannot connect (timeout, DNS error or 404) | Wrong base URL or no network access | Make sure `GOOGLE_GEMINI_BASE_URL` is `https://api.relayvia.dev`, without /v1. |