# Goose

> Add Tchavi to Goose with a ready-made provider file and run it on credits topped up by mobile money.

- Canonical: https://tchavi.com/en/docs/coding-agents/goose

---


Part of the [coding agents](/docs/coding-agents) guides.

Goose is an open-source agent that runs in your terminal or as a desktop app and works on your project with the model you choose. It loads extra providers from JSON files, and Tchavi publishes one, so Tchavi shows up in Goose's provider list like a built-in.

## 1. Download the provider file

Goose reads every `.json` file in its `custom_providers` folder when it starts.

On macOS or Linux:

```bash
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://tchavi.com/goose/tchavi.json -o ~/.config/goose/custom_providers/tchavi.json
```

On Windows, in PowerShell:

```powershell
$dir = "$env:APPDATA\Block\goose\config\custom_providers"
New-Item -ItemType Directory -Force $dir | Out-Null
Invoke-WebRequest https://tchavi.com/goose/tchavi.json -OutFile "$dir\tchavi.json"
```

If Goose Desktop was open, quit and reopen it. This is the whole file:

```json
{
  "name": "tchavi",
  "engine": "openai",
  "display_name": "Tchavi",
  "description": "One API key for 100+ text, image, video and audio models, paid with mobile money from a single credit balance.",
  "api_key_env": "TCHAVI_API_KEY",
  "base_url": "https://tchavi.com/api/v1",
  "dynamic_models": true,
  "models": [
    { "name": "claude-sonnet-5-5", "context_limit": 1000000 },
    { "name": "gpt-6-sol", "context_limit": 272000 },
    { "name": "deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true,
  "model_doc_link": "https://tchavi.com/models?utm_source=goose&utm_medium=docs",
  "setup_steps": [
    "Create an account at https://tchavi.com/register?utm_source=goose&utm_medium=docs",
    "Top up your credit balance with mobile money at https://tchavi.com/dashboard/billing?utm_source=goose&utm_medium=docs",
    "Create an API key at https://tchavi.com/dashboard/api-keys?utm_source=goose&utm_medium=docs",
    "Paste the key above as TCHAVI_API_KEY",
    "Full guide: https://tchavi.com/docs/coding-agents/goose?utm_source=goose&utm_medium=docs"
  ]
}
```

The file holds no key. It only names the variable Goose reads the key from, `TCHAVI_API_KEY`.

## 2. Set the key

Create a key in the [dashboard](/dashboard/api-keys) and top up your balance from the [billing page](/dashboard/billing) before the first call. [Mobile money payments](/docs/payments) lists the countries and operators.

In the terminal, export the key in the shell you start Goose from:

```bash
export TCHAVI_API_KEY=sk-tch-your-key
```

In Goose Desktop, open **Settings**, then **Models**, then **Configure providers**, pick **Tchavi** and paste the key. Goose keeps it in your system keychain.

## 3. Send a first prompt

From the folder of a project:

```bash
goose session --provider tchavi --model deepseek-v4.1-flash
```

Then ask something that makes Goose use its tools:

```text
List the files in this folder and tell me in two sentences what this project does.
```

For a single run without the interactive session:

```bash
goose run --provider tchavi --model deepseek-v4.1-flash -t "Summarise the README in three bullet points."
```

To make Tchavi the default, set `GOOSE_PROVIDER=tchavi` and `GOOSE_MODEL=deepseek-v4.1-flash`, or pick them once in `goose configure`.

## Models

The file declares three models so the picker is never empty:

| Model                 | Good for                                |
| --------------------- | --------------------------------------- |
| `claude-sonnet-5-5`   | The default for most coding work        |
| `gpt-6-sol`           | An alternative that supports tool calls |
| `deepseek-v4.1-flash` | Routine edits and background tasks      |

Because `dynamic_models` is on, Goose also asks Tchavi for the full list (`GET /v1/models`) with your key, so any id that endpoint returns works with `--model`. Goose drives your project through tool calls: pick a model whose `capabilities.tools` is `true` in that list. Prices per model are in the [catalogue](/models).

<Callout type="note" title="Why gpt-6-sol says 272,000">
  `context_limit` tells Goose how much room a model has. GPT-6 Sol accepts more, but a prompt past
  272,000 tokens is billed at its higher long-prompt rate, shown on its [model
  page](/m/openai/gpt-6-sol). Raise the number in your copy of the file if you want the full window.
</Callout>

<Callout type="warning" title="Keep the key out of the file">
  Never write the key into `tchavi.json`. Teams often share provider files or commit them, and the
  key would travel with it. The environment variable or the keychain is the safe place.
</Callout>

## When something fails

| What you see                          | What it means                                    | Fix                                                                                |
| ------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------- |
| `missing required key TCHAVI_API_KEY` | Goose found no key                               | Export it in the shell you launch Goose from, or paste it in Goose Desktop         |
| `401` / `invalid_api_key`             | The key is wrong, revoked or not a Tchavi key    | Create a new key in the [dashboard](/dashboard/api-keys); it starts with `sk-tch-` |
| `402` / `insufficient_credits`        | Your balance is too low for this request         | Top up from the [billing page](/dashboard/billing); see [payments](/docs/payments) |
| `404` / `model_not_found`             | No model has that id                             | Check the spelling against `GET /v1/models`                                        |
| `403` / `model_not_allowed`           | That model exists but is not available           | Pick another id from `GET /v1/models`                                              |
| Tchavi missing from the provider list | The file is not in the `custom_providers` folder | Check the path and the `.json` extension, then restart Goose                       |

Every request Goose sends appears under **Usage** in the dashboard, with its model, token counts and credits charged.

---

Back to [coding agents](/docs/coding-agents)

