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 :

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

Sur Windows, dans 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"

Si Goose Desktop était ouvert, quittez-le et rouvrez-le. Voici le fichier complet :

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"
  ]
}

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 :

Bash
export TCHAVI_API_KEY=sk-tch-votre-cle

Dans 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 :

Bash
goose session --provider tchavi --model deepseek-v4.1-flash

Puis demandez quelque chose qui oblige Goose à utiliser ses outils :

text
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 :

Bash
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èleBien pour
claude-sonnet-5-5Le choix par défaut pour la plupart du code
gpt-6-solUne alternative qui prend en charge les appels d'outils
deepseek-v4.1-flashLes 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 voyezCe que cela signifieSolution
missing required key TCHAVI_API_KEYGoose n'a trouvé aucune cléExportez-la dans le shell depuis lequel vous lancez Goose, ou collez-la dans Goose Desktop
401 / invalid_api_keyLa clé est fausse, révoquée ou n'est pas une clé TchaviCréez une nouvelle clé dans le tableau de bord ; elle commence par sk-tch-
402 / insufficient_creditsVotre solde est trop bas pour cette requêteRechargez depuis la page de facturation ; voir paiements
404 / model_not_foundAucun modèle n'a cet identifiantVérifiez l'orthographe avec GET /v1/models
403 / model_not_allowedCe modèle existe mais n'est pas disponibleChoisissez un autre identifiant dans GET /v1/models
Tchavi absent de la liste des fournisseursLe fichier n'est pas dans le dossier custom_providersVé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

Sur cette page