goose installeren en een aangepaste provider configureren

goose is een AI-assistent voor algemeen gebruik die op je computer draait. Naast coderen kan het onderzoek, schrijven, automatisering en gegevensorganisatie afhandelen. Je kunt het gebruiken via de desktop-app, terminal of API, en de desktop- en terminalversies delen dezelfde modelconfiguratie. Het is geschikt voor repetitieve codeertaken en kan ook verbinding maken met GitHub, databases en bestanden.

Voordat je begint

goose biedt twee installatieopties: Desktop en CLI. Desktop is de grafische versie met een venster, terwijl CLI wordt gebruikt door opdrachten in een terminal in te voeren. Beide delen dezelfde kernconfiguratie, inclusief de Provider en het model. Een Provider is de verbindingsconfiguratie die goose vertelt welke modelservice moet worden gebruikt.

Wil je een venster

goose Desktop

Download de zip op macOS
Of gebruik brew cask
Gebruik het installatiepakket op Linux

Alleen terminal

goose CLI

download_cli.sh
Of de Homebrew CLI
Voer daarna goose session uit

Windows

Kies eerst een omgeving

Git Bash of MSYS2
Je kunt ook PowerShell gebruiken
Als de opdracht niet wordt gevonden, voeg deze dan toe aan PATH

Op macOS kun je het installeren door de app te downloaden of Homebrew te gebruiken. Gebruik op Linux het pakket van je distributie voor de desktopversie. Controleer op Windows eerst de ondersteunde terminalomgevingen.

Houd voordat je begint het model-ID uit de huidige modellijst bij de hand. Een model-ID is de naam die de modelservice gebruikt om een specifiek model te identificeren, en je moet het volledige ID kopiëren wanneer je het gebruikt.

Installeren en voor de eerste keer opstarten

Als je een grafisch venster wilt

Er zijn twee gedocumenteerde installatiemethoden voor macOS:

Download het van de installatiepagina. De pagina biedt macOS Silicon- en macOS Intel-versies. Pak na het downloaden het zip-bestand uit en voer de applicatie binnenin uit.
Gebruik als alternatief Homebrew:

brew install --cask block-goose

Dit downloadt dezelfde applicatie en kan ook updates afhandelen.

Als je een Apple Mac M3 gebruikt en er verschijnt geen venster na het openen van de app, controleer dan of ~/.config lees- en schrijfbaar is. goose gebruikt deze map om logbestanden te schrijven.

Download voor de Linux-desktopversie de versie van de installatiepagina. De beschikbare pakketten zijn DEB voor Ubuntu/Debian, RPM voor RHEL/Fedora en Flatpak. Download op Debian of Ubuntu het DEB-bestand, open de map waar het is opgeslagen, voer sudo dpkg -i (filename).debuit en open vervolgens goose vanuit het applicatiemenu. Vervang (filename) door de werkelijke bestandsnaam.

Download voor de Windows-desktopversie de versie van de installatiepagina, pak het zip-bestand uit en voer de applicatie binnenin uit.

Als je alleen de terminalversie wilt

Voer op macOS en Linux het volgende uit:

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

Om interactieve configuratie tijdens de installatie over te slaan, voeg CONFIGURE=false toe voor bash:

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

Op macOS kun je ook het volgende uitvoeren:

brew install block-goose-cli

Voer het volgende uit om een geïnstalleerde CLI bij te werken:

goose update

Op Windows is een van de volgende drie omgevingen vereist: Git Bash, die is inbegrepen bij Git for Windows en als aanbevolen is gemarkeerd; MSYS2; of PowerShell inbegrepen bij Windows 10/11. Gebruik in Git Bash en MSYS2 dezelfde download_cli.sh opdracht als hierboven getoond. Download in PowerShell eerst het script en voer het vervolgens uit:

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

Als je te horen krijgt dat goose niet in PATH staat, volg dan de installatiepagina en voeg ~/.local/bin of %USERPROFILE%\.local\bin toe aan de huidige shell-configuratie en open de terminal opnieuw. PATH is een reeks mappen die de terminal doorzoekt naar programma’s. Als de installatiemap niet is opgenomen, kun je mogelijk geen geïnstalleerd programma uitvoeren door de naam ervan direct in te voeren.

Per 09-10-2026 was de CLI-versie 1.54.0. Standaard plaatst het installatiescript het programma in ~/.local/bin. Je kunt deze map wijzigen met de GOOSE_BIN_DIR omgevingsvariabele. Als je deze wijzigt, zal het script de shell-configuratie niet automatisch bijwerken en zal de terminal melden dat de map niet in PATH staat. Voeg die map toe aan PATH of voer goose uit met het volledige pad.

De eerste keer dat je goose gebruikt, zal het je vragen om een Provider te configureren. Je kunt de ingebouwde providers overslaan en een aangepaste Provider toevoegen zoals beschreven in het volgende gedeelte. Navigeer in de terminal naar de map waar je wilt werken en voer het volgende uit:

goose session

Verbindingswaarden ophalen van OmniProxy

Bereid het adres, de sleutel en de modelnaam voor van je eigen OmniProxy-instantie. Het voorbeeld van de aangepaste Provider gebruikt een base_url eindigend op /v1/chat/completions, dus deze gids volgt hetzelfde formaat:

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

Kopieer de volledige modelnaam uit de huidige OmniProxy-lijst, inclusief eventuele slashes. Per 09-10-2026 waren twee referentie-ID’s in de providerdocumentatie grok-4.7 voor Grok en gpt-6-luna uit de OpenAI-documentatie. gpt-6-luna ondersteunt Chat Completions; functie-aanroepen in Chat Completions worden alleen ondersteund wanneer reasoning_effort is ingesteld op none. Kopieer geen naam die niet in de lijst voorkomt.

De toolconfiguratie invoeren

Een aangepaste Provider kan een OpenAI-, Anthropic- of Ollama-compatibel formaat gebruiken. Een compatibel formaat betekent dat de tool verzoeken verzendt volgens een algemene API-specificatie. Selecteer bij het verbinden met OmniProxy OpenAI Compatible.

Desktop

Klik op de knop in de linkerbovenhoek om de zijbalk te openen.
Klik op Settings.
Klik op Models.
Klik op Configure providers.
Klik onderaan het venster op Add Custom Provider.
Selecteer bij Provider Type OpenAI Compatible. Je kunt Display Name instellen op OmniProxy. Voer het adres uit het vorige gedeelte in bij API URL. Als een sleutel vereist is, selecteer dan de optie die een API Key vereist en voer je OmniProxy-sleutel in. Voer bij Available Models de modelnamen in en scheid meerdere namen met komma’s.
Klik op Create Provider.

De desktopversie kan momenteel geen aangepaste verzoekheaders definiëren in dit venster. Als je verzoekheaders nodig hebt, bewerk dan het configuratiebestand nadat je de Provider hebt aangemaakt.

Terminal

Voer het volgende uit:

goose configure

Selecteer Custom Providers en selecteer vervolgens Add A Custom Provider. Selecteer bij API Type OpenAI Compatible en volg daarna de aanwijzingen om de naam, API URL, of een sleutel vereist is, modelnamen en of streaming-antwoorden worden ondersteund in te voeren.

Als de keychain een fout meldt bij het handmatig configureren op Windows, zeggen de installatie-instructies dat je het opslaan van de sleutel in de keychain moet weigeren en in plaats daarvan een omgevingsvariabele moet gebruiken. Voer daarna goose configure opnieuw uit. De keychain is een klein beveiligd opslagsysteem dat door het besturingssysteem wordt gebruikt om geheimen op te slaan.

Configuratiebestand

De gedocumenteerde mappen zijn:

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

Je kunt het bestand baseren op het verstrekte voorbeeld. Vervang de naam, het adres en de modellen door je eigen waarden. Sla de sleutel op in de omgevingsvariabele gespecificeerd door api_key_env; schrijf de echte sleutel niet in het bestand:

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

Houd een numerieke waarde aan voor context_limit, zoals getoond in het voorbeeld. De werkelijke contextlimiet hangt af van het model en OmniProxy; behandel het voorbeeldgetal niet als de officiële limiet van het model. Voer voordat je het gebruikt het volgende uit:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Voer na het betreden van de werkmap het volgende uit:

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

Vervang de waarde van --model door het volledige ID uit de lijst. goose session heeft geen start subcommando. Je kunt ook --provider en --model instellen via de GOOSE_PROVIDER en GOOSE_MODEL omgevingsvariabelen. Zelfs als de gateway geen sleutels valideert, OMNIPROXY_API_KEY moet nog steeds een waarde hebben. Het kan een tijdelijke aanduiding zijn die alleen op je lokale computer wordt gebruikt. Deze configuratie heeft tijdens het testen op 09-10-2026 met succes een bestand gelezen.

Venster

Instellingen

Instellingen in de zijbalk
Modellenpagina
Aangepaste provider toevoegen

Terminal

goose configure

Selecteer Aangepaste providers
Selecteer vervolgens toevoegen
Kies OpenAI Compatible als het type

Bestand

custom_providers

Op macOS en Linux staat dit onder ~/.config
Op Windows staat dit onder APPDATA
Stel base_url in volgens het officiële voorbeeld

Alle drie de methoden creëren hetzelfde type configuratie. Selecteer OpenAI Compatible als het Provider-type.

Verifiëren met een echte taak

Open een map die een gewoon bestand bevat en voer goose session uit zoals getoond in het vorige gedeelte. Vraag het om de eerste regel van een bestand dat je opgeeft te lezen. Het zou de bestandsinhoud moeten retourneren in plaats van alleen te zeggen dat de configuratie is opgeslagen.

Om bestanden te lezen of opdrachten uit te voeren, heeft de sessie de Developer-extensie nodig. De Developer-extensie is een toolmodule waarmee goose met lokale bestanden en opdrachten kan werken. Deze is over het algemeen inbegrepen in de standaardconfiguratie. Als goose zegt dat het geen bestandstools heeft, voeg dan het volgende toe aan de opdracht:

--with-builtin developer

Voeg niet ook --no-profiletoe, omdat die optie de standaardextensies uitschakelt.

Bij het testen op 09-10-2026 las goose 1.54.0 met succes de eerste regel van het opgegeven bestand. De eerste reactie kan ongeveer één minuut duren.

Controleer vervolgens de OmniProxy-verzoeklogboeken om de bron en modelnaam te bevestigen.

Opstarten

Er opent een sessie

goose session
Provider is degene die zojuist is toegevoegd
De modelnaam staat in de lijst

Taak

Het heeft de taak daadwerkelijk voltooid

Lijst bijvoorbeeld de huidige map op
Bekijk de reactie
Vertrouw niet alleen op een succesvolle opslag

Logboeken

Zichtbaar in de gateway

Gebruik het adres uit het documentatievoorbeeld
Zet de sleutel niet in de repository
Het model-ID komt overeen met de lijst

Bevestig de Provider na het opslaan met een echte sessie.

Veelvoorkomende fouten

De goose opdracht kan niet worden gevonden: Voeg de installatiemap toe aan PATH zoals beschreven op de installatiepagina en open de terminal opnieuw.
Er verschijnt geen venster in de desktopversie op een M3 Mac: Controleer de lees- en schrijfrechten voor ~/.config.
De keychain mislukt: Sla de sleutel niet op in de keychain; gebruik in plaats daarvan een omgevingsvariabele.
Het model staat niet in de lijst: Selecteer in de desktopversie Use custom model en voer de modelnaam handmatig in. goose configure kan geen aangepaste modelnaam accepteren. Schakel voor terminalgebruik over naar de desktopversie of bewerk GOOSE_MODEL direct in de configuratie.
Het adres is onbereikbaar: Bevestig dat de API URL eindigt op /v1/chat/completions, zoals in het voorbeeld, en dat OmniProxy draait.
Er staat dat het geen bestanden kan lezen: Voeg de Developer-extensie toe en gebruik niet --no-profile.
Het retourneert unsupported Responses role: system: Het adres is meestal correct. Schakel over naar een ander volledig ID uit de modellijst.

Officiële referenties

Zie Install goose voor installatie. Zie goose providers voor aangepaste Providers. Zie de xAI models page en GPT-6 Luna.

Vervang elke placeholder met waarden uit uw eigen OmniProxy-configuratie. Publiceer nooit een echte sleutel.

Een opgeslagen resultaat of HTTP 200 alleen bewijst geen volledige Agent-compatibiliteit. Controleer de bron en het model in het oproeprecord van OmniProxy.

Officiële bronnen · goose ↗