Goose

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

Part of the 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 and top up your balance from the billing page before the first call. Mobile money 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:

ModelGood for
claude-sonnet-5-5The default for most coding work
gpt-6-solAn alternative that supports tool calls
deepseek-v4.1-flashRoutine 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.

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. Raise the number in your copy of the file if you want the full window.

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.

When something fails

What you seeWhat it meansFix
missing required key TCHAVI_API_KEYGoose found no keyExport it in the shell you launch Goose from, or paste it in Goose Desktop
401 / invalid_api_keyThe key is wrong, revoked or not a Tchavi keyCreate a new key in the dashboard; it starts with sk-tch-
402 / insufficient_creditsYour balance is too low for this requestTop up from the billing page; see payments
404 / model_not_foundNo model has that idCheck the spelling against GET /v1/models
403 / model_not_allowedThat model exists but is not availablePick another id from GET /v1/models
Tchavi missing from the provider listThe file is not in the custom_providers folderCheck 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

On this page