Goose
Ajoutez Tchavi à Goose avec un fichier de fournisseur prêt à l'emploi et faites-le tourner sur des crédits rechargés par mobile money.
Fait partie des guides agents de code.
Goose est un agent open source qui tourne dans votre terminal ou en application de bureau et travaille sur votre projet avec le modèle de votre choix. Il charge des fournisseurs supplémentaires depuis des fichiers JSON, et Tchavi en publie un : Tchavi apparaît donc dans la liste des fournisseurs de Goose comme un fournisseur intégré.
1. Télécharger le fichier du fournisseur
Goose lit chaque fichier .json de son dossier custom_providers au démarrage.
Sur macOS ou Linux :
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://tchavi.com/goose/tchavi.json -o ~/.config/goose/custom_providers/tchavi.jsonSur Windows, dans 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"Si Goose Desktop était ouvert, quittez-le et rouvrez-le. Voici le fichier complet :
{
"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"
]
}Le fichier ne contient aucune clé. Il nomme seulement la variable où Goose va la lire, TCHAVI_API_KEY. Les textes du fichier sont en anglais, la langue de l'interface de Goose.
2. Renseigner la clé
Créez une clé dans le tableau de bord et rechargez votre solde depuis la page de facturation avant le premier appel. Paiements mobile money liste les pays et les opérateurs.
Dans le terminal, exportez la clé dans le shell depuis lequel vous lancez Goose :
export TCHAVI_API_KEY=sk-tch-votre-cleDans Goose Desktop, ouvrez Settings, puis Models, puis Configure providers, choisissez Tchavi et collez la clé. Goose la garde dans le trousseau de votre système.
3. Envoyer un premier prompt
Depuis le dossier d'un projet :
goose session --provider tchavi --model deepseek-v4.1-flashPuis demandez quelque chose qui oblige Goose à utiliser ses outils :
Liste les fichiers de ce dossier et dis-moi en deux phrases ce que fait ce projet.Pour une seule exécution, sans session interactive :
goose run --provider tchavi --model deepseek-v4.1-flash -t "Résume le README en trois points."Pour faire de Tchavi le choix par défaut, définissez GOOSE_PROVIDER=tchavi et GOOSE_MODEL=deepseek-v4.1-flash, ou choisissez-les une fois dans goose configure.
Modèles
Le fichier déclare trois modèles pour que le sélecteur ne soit jamais vide :
| Modèle | Bien pour |
|---|---|
claude-sonnet-5-5 | Le choix par défaut pour la plupart du code |
gpt-6-sol | Une alternative qui prend en charge les appels d'outils |
deepseek-v4.1-flash | Les modifications courantes et les tâches de fond |
Comme dynamic_models est activé, Goose demande aussi la liste complète à Tchavi (GET /v1/models) avec votre clé : tout identifiant renvoyé par cet endpoint fonctionne avec --model. Goose pilote votre projet par des appels d'outils : choisissez un modèle dont capabilities.tools vaut true dans cette liste. Les prix de chaque modèle sont dans le catalogue.
Pourquoi 272 000 pour gpt-6-sol
context_limit indique à Goose la place dont dispose un modèle. GPT-6 Sol accepte davantage, mais
un prompt de plus de 272 000 tokens est facturé à son tarif plus élevé pour les prompts longs,
affiché sur sa page modèle. Augmentez ce nombre dans votre copie du fichier
si vous voulez toute la fenêtre.
Gardez la clé hors du fichier
N'écrivez jamais la clé dans tchavi.json. Les équipes partagent souvent leurs fichiers de
fournisseurs ou les commitent, et la clé partirait avec. La variable d'environnement ou le
trousseau sont les bons endroits.
Quand quelque chose échoue
| Ce que vous voyez | Ce que cela signifie | Solution |
|---|---|---|
missing required key TCHAVI_API_KEY | Goose n'a trouvé aucune clé | Exportez-la dans le shell depuis lequel vous lancez Goose, ou collez-la dans Goose Desktop |
401 / invalid_api_key | La clé est fausse, révoquée ou n'est pas une clé Tchavi | Créez une nouvelle clé dans le tableau de bord ; elle commence par sk-tch- |
402 / insufficient_credits | Votre solde est trop bas pour cette requête | Rechargez depuis la page de facturation ; voir paiements |
404 / model_not_found | Aucun modèle n'a cet identifiant | Vérifiez l'orthographe avec GET /v1/models |
403 / model_not_allowed | Ce modèle existe mais n'est pas disponible | Choisissez un autre identifiant dans GET /v1/models |
| Tchavi absent de la liste des fournisseurs | Le fichier n'est pas dans le dossier custom_providers | Vérifiez le chemin et l'extension .json, puis redémarrez Goose |
Chaque requête envoyée par Goose apparaît dans Usage du tableau de bord, avec son modèle, ses tokens et les crédits débités.
Retour aux agents de code