Installation de goose et configuration d'un fournisseur personnalisé

goose est un assistant IA polyvalent qui s’exécute sur votre ordinateur. En plus du codage, il peut gérer la recherche, l’écriture, l’automatisation et l’organisation de données. Vous pouvez l’utiliser via l’application de bureau, le terminal ou l’API, et les versions de bureau et de terminal partagent la même configuration de modèle. Il est adapté aux tâches de codage répétitives et peut également se connecter à GitHub, aux bases de données et aux fichiers.

Avant de commencer

goose propose deux options d’installation : Desktop et CLI. Desktop est la version graphique avec une fenêtre, tandis que CLI est utilisée en saisissant des commandes dans un terminal. Les deux partagent la même configuration de base, y compris le fournisseur (Provider) et le modèle. Un fournisseur est la configuration de connexion qui indique à goose quel service de modèle utiliser.

Vous voulez une fenêtre

goose Desktop

Télécharger le zip sur macOS
Ou utiliser brew cask
Utiliser le paquet d'installation sur Linux

Terminal uniquement

goose CLI

download_cli.sh
Ou le CLI Homebrew
Puis exécuter goose session

Windows

Choisir d'abord un environnement

Git Bash ou MSYS2
Vous pouvez également utiliser PowerShell
Si la commande est introuvable, ajoutez-la au PATH

Sur macOS, vous pouvez l'installer en téléchargeant l'application ou en utilisant Homebrew. Sur Linux, utilisez le paquet de votre distribution pour la version de bureau. Sur Windows, vérifiez d'abord les environnements de terminal pris en charge.

Avant de commencer, préparez l’ID du modèle à partir de la liste actuelle des modèles. Un ID de modèle est le nom que le service de modèle utilise pour identifier un modèle spécifique, et vous devez copier l’ID complet lors de son utilisation.

Installation et premier lancement

Si vous voulez une fenêtre graphique

Il existe deux méthodes d’installation documentées pour macOS :

Téléchargez-le depuis la page d’installation. La page fournit des versions macOS Silicon et macOS Intel. Après le téléchargement, extrayez le fichier zip et exécutez l’application à l’intérieur.
Alternativement, utilisez Homebrew :

brew install --cask block-goose

Cela télécharge la même application et peut également gérer les mises à jour.

Si vous utilisez un Apple Mac M3 et qu’aucune fenêtre n’apparaît après l’ouverture de l’application, vérifiez si ~/.config est lisible et inscriptible. goose utilise ce répertoire pour écrire des journaux.

Pour la version de bureau Linux, téléchargez-la depuis la page d’installation. Les paquets disponibles sont DEB pour Ubuntu/Debian, RPM pour RHEL/Fedora et Flatpak. Sur Debian ou Ubuntu, téléchargez le fichier DEB, ouvrez le répertoire où il a été enregistré, exécutez sudo dpkg -i (filename).deb, puis ouvrez goose depuis le menu des applications. Remplacez (filename) par le nom réel du fichier.

Pour la version de bureau Windows, téléchargez-la depuis la page d’installation, extrayez le fichier zip et exécutez l’application à l’intérieur.

Si vous voulez uniquement la version terminal

Sur macOS et Linux, exécutez :

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Pour ignorer la configuration interactive pendant l’installation, ajoutez CONFIGURE=false avant bash:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

Sur macOS, vous pouvez également exécuter :

brew install block-goose-cli

Pour mettre à jour un CLI installé, exécutez :

goose update

Sur Windows, l’un des trois environnements suivants est requis : Git Bash, qui est inclus avec Git pour Windows et marqué comme recommandé ; MSYS2 ; ou PowerShell inclus avec Windows 10/11. Dans Git Bash et MSYS2, utilisez la même commande download_cli.sh indiquée ci-dessus. Dans PowerShell, téléchargez d’abord le script, puis exécutez-le :

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

Si on vous dit que goose n’est pas dans le PATH, suivez la page d’installation et ajoutez ~/.local/bin ou %USERPROFILE%\.local\bin à la configuration actuelle du shell, puis rouvrez le terminal. PATH est un ensemble de répertoires dans lesquels le terminal recherche des programmes. Si le répertoire d’installation n’est pas inclus, vous pourriez être incapable d’exécuter un programme installé en saisissant son nom directement.

Au 09/10/2026, la version CLI était 1.54.0. Par défaut, le script d’installation place le programme dans ~/.local/bin. Vous pouvez changer ce répertoire avec la variable d’environnement GOOSE_BIN_DIR . Si vous le changez, le script ne mettra pas automatiquement à jour la configuration du shell, et le terminal signalera que le répertoire n’est pas dans le PATH. Ajoutez ce répertoire au PATH ou exécutez goose en utilisant son chemin complet.

La première fois que vous utilisez goose, il vous demandera de configurer un fournisseur. Vous pouvez ignorer les fournisseurs intégrés et ajouter un fournisseur personnalisé comme décrit dans la section suivante. Dans le terminal, accédez au répertoire où vous souhaitez travailler et exécutez :

goose session

Obtenir les valeurs de connexion depuis OmniProxy

Préparez l’adresse, la clé et le nom du modèle à partir de votre propre instance OmniProxy. L’exemple de fournisseur personnalisé utilise une base_url se terminant par /v1/chat/completions, ce guide suit donc le même format :

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Copy from the current OmniProxy model list; separate multiple models with commas

Copiez le nom complet du modèle depuis la liste actuelle d’OmniProxy, y compris les barres obliques. Au 09/10/2026, deux ID de référence dans la documentation du fournisseur étaient grok-4.7 pour Grok et gpt-6-luna à partir de la documentation OpenAI. gpt-6-luna prend en charge les complétions de chat (Chat Completions) ; l’appel de fonction dans les complétions de chat n’est pris en charge que lorsque reasoning_effort est défini sur none. Ne copiez pas un nom qui n’apparaît pas dans la liste.

Entrer la configuration de l’outil

Un fournisseur personnalisé peut utiliser un format compatible OpenAI, Anthropic ou Ollama. Un format compatible signifie que l’outil envoie des requêtes selon une spécification d’API commune. Lors de la connexion à OmniProxy, sélectionnez OpenAI Compatible.

Desktop

Cliquez sur le bouton dans le coin supérieur gauche pour ouvrir la barre latérale.
Cliquez sur Settings.
Cliquez sur Models.
Cliquez sur Configure providers.
Cliquez sur Add Custom Provider au bas de la fenêtre.
Pour le type de fournisseur, sélectionnez OpenAI Compatible. Vous pouvez définir le nom d’affichage (Display Name) sur OmniProxy. Saisissez l’adresse de la section précédente dans l’URL de l’API (API URL). Si une clé est requise, sélectionnez l’option nécessitant une clé API et saisissez votre clé OmniProxy. Dans les modèles disponibles (Available Models), saisissez les noms des modèles, en séparant les noms multiples par des virgules.
Cliquez sur Create Provider.

La version de bureau ne peut actuellement pas définir d’en-têtes de requête personnalisés dans cette fenêtre. Si vous avez besoin d’en-têtes de requête, modifiez le fichier de configuration après avoir créé le fournisseur.

Terminal

Exécutez :

goose configure

Sélectionnez Custom Providers, puis sélectionnez Add A Custom Provider. Pour le type d’API, sélectionnez OpenAI Compatible, puis suivez les invites pour saisir le nom, l’URL de l’API, si une clé est requise, les noms des modèles et si les réponses en streaming sont prises en charge.

Lors de la configuration manuelle sur Windows, si le trousseau (keychain) signale une erreur, les instructions d’installation indiquent de refuser l’enregistrement de la clé dans le trousseau et d’utiliser une variable d’environnement à la place. Ensuite, exécutez goose configure à nouveau. Le trousseau est un petit système de stockage sécurisé utilisé par le système d’exploitation pour stocker des secrets.

Fichier de configuration

Les répertoires documentés sont :

macOS et Linux : ~/.config/goose/custom_providers/
Windows : %APPDATA%\Block\goose\config\custom_providers\

Vous pouvez baser le fichier sur l’exemple fourni. Remplacez le nom, l’adresse et les modèles par vos propres valeurs. Stockez la clé dans la variable d’environnement spécifiée par api_key_env; n’écrivez pas la vraie clé dans le fichier :

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Gardez une valeur numérique pour context_limit, comme indiqué dans l’exemple. La limite de contexte réelle dépend du modèle et d’OmniProxy ; ne traitez pas le nombre de l’exemple comme la limite officielle du modèle. Avant de l’utiliser, exécutez :

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Après être entré dans le répertoire de travail, exécutez :

goose session --provider omniproxy --model grok-4.7

Remplacez la valeur de --model par l’ID complet de la liste. goose session n’a pas de start sous-commande. Vous pouvez également définir --provider et --model via les GOOSE_PROVIDER et GOOSE_MODEL variables d’environnement. Même si la passerelle ne valide pas les clés, OMNIPROXY_API_KEY doit toujours avoir une valeur. Il peut s’agir d’une chaîne de caractères fictive utilisée uniquement sur votre ordinateur local. Cette configuration a lu avec succès un fichier lors des tests le 09/10/2026.

Fenêtre

Paramètres

Paramètres dans la barre latérale
Page des modèles
Ajouter un fournisseur personnalisé

Terminal

goose configure

Sélectionner les fournisseurs personnalisés
Puis sélectionner ajouter
Choisir OpenAI Compatible comme type

Fichier

custom_providers

Sur macOS et Linux, il est sous ~/.config
Sur Windows, il est sous APPDATA
Définir base_url selon l'exemple officiel

Les trois méthodes créent le même type de configuration. Sélectionnez OpenAI Compatible comme type de fournisseur.

Vérifier avec une tâche réelle

Ouvrez un répertoire contenant un fichier régulier et exécutez goose session comme indiqué dans la section précédente. Demandez-lui de lire la première ligne d’un fichier que vous spécifiez. Il devrait renvoyer le contenu du fichier plutôt que de simplement dire que la configuration a été enregistrée.

Pour lire des fichiers ou exécuter des commandes, la session a besoin de l’extension Developer. L’extension Developer est un module d’outils qui permet à goose de travailler avec des fichiers et des commandes locaux. Elle est généralement incluse dans la configuration par défaut. Si goose dit qu’il n’a pas d’outils de fichiers, ajoutez ce qui suit à la commande :

--with-builtin developer

N’ajoutez pas non plus --no-profile, car cette option désactive les extensions par défaut.

Lors des tests le 09/10/2026, goose 1.54.0 a lu avec succès la première ligne du fichier spécifié. La première réponse peut prendre environ une minute.

Ensuite, vérifiez les journaux de requêtes d’OmniProxy pour confirmer la source et le nom du modèle.

Lancement

Une session s'ouvre

goose session
Le fournisseur est celui qui vient d'être ajouté
Le nom du modèle est dans la liste

Tâche

Il a réellement terminé la tâche

Par exemple, lister le répertoire actuel
Examiner sa réponse
Ne vous fiez pas uniquement à un enregistrement réussi

Journaux

Visible dans la passerelle

Utiliser l'adresse de l'exemple de la documentation
Ne pas mettre la clé dans le dépôt
L'ID du modèle correspond à la liste

Après avoir enregistré le fournisseur, confirmez-le avec une session réelle.

Erreurs courantes

La goose commande est introuvable : Ajoutez le répertoire d’installation au PATH comme décrit sur la page d’installation, puis rouvrez le terminal.
Aucune fenêtre n’apparaît dans la version de bureau sur un Mac M3 : Vérifiez les autorisations de lecture et d’écriture pour ~/.config.
Le trousseau échoue : N’enregistrez pas la clé dans le trousseau ; utilisez une variable d’environnement à la place.
Le modèle n’est pas dans la liste : Dans la version de bureau, sélectionnez Use custom model et saisissez le nom du modèle manuellement. goose configure ne peut pas accepter un nom de modèle personnalisé. Pour une utilisation dans le terminal, passez à la version de bureau ou modifiez GOOSE_MODEL directement dans la configuration.
L’adresse ne peut pas être atteinte : Confirmez que l’URL de l’API se termine par /v1/chat/completions, comme dans l’exemple, et qu’OmniProxy est en cours d’exécution.
Il dit qu’il ne peut pas lire les fichiers : Ajoutez l’extension Developer et n’utilisez pas --no-profile.
Il renvoie unsupported Responses role: system: L’adresse est généralement correcte. Passez à un autre ID complet de la liste des modèles.

Références officielles

Pour l’installation, voir Installer goose. Pour les fournisseurs personnalisés, voir fournisseurs goose. Pour les ID de modèles utilisés dans les exemples, voir la page des modèles xAI et GPT-6 Luna.

Remplacez chaque espace réservé par des valeurs de votre propre configuration OmniProxy. Ne publiez jamais une vraie clé.

Un résultat sauvegardé ou un HTTP 200 seul ne prouve pas une compatibilité complète de l'Agent. Vérifiez la source et le modèle dans l'enregistrement d'appel d'OmniProxy.

Sources officielles · goose ↗