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:
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://tchavi.com/goose/tchavi.json -o ~/.config/goose/custom_providers/tchavi.jsonOn Windows, in 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:
{
"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:
export TCHAVI_API_KEY=sk-tch-your-keyIn 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:
goose session --provider tchavi --model deepseek-v4.1-flashThen ask something that makes Goose use its tools:
List the files in this folder and tell me in two sentences what this project does.For a single run without the interactive session:
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.
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 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; it starts with sk-tch- |
402 / insufficient_credits | Your balance is too low for this request | Top up from the billing page; see 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