Installation af goose og konfiguration af en brugerdefineret udbyder

goose er en AI-assistent til generelle formål, der kører på din computer. Udover kodning kan den håndtere research, skrivning, automatisering og dataorganisering. Du kan bruge den via desktop-appen, terminalen eller API’et, og desktop- og terminalversionerne deler den samme modelkonfiguration. Den er velegnet til gentagne kodningsopgaver og kan også forbindes til GitHub, databaser og filer.

Før du starter

goose tilbyder to installationsmuligheder: Desktop og CLI. Desktop er den grafiske version med et vindue, mens CLI bruges ved at indtaste kommandoer i en terminal. Begge deler den samme kernekonfiguration, inklusive udbyder og model. En udbyder er forbindelseskonfigurationen, der fortæller goose, hvilken modeltjeneste den skal bruge.

Vil have et vindue

goose Desktop

Download zip-filen på macOS
Eller brug brew cask
Brug installer-pakken på Linux

Kun terminal

goose CLI

download_cli.sh
Eller Homebrew CLI
Kør derefter goose session

Windows

Vælg et miljø først

Git Bash eller MSYS2
Du kan også bruge PowerShell
Hvis kommandoen ikke findes, tilføj den til PATH

På macOS kan du installere den ved at downloade appen eller bruge Homebrew. På Linux skal du bruge din distributions pakke til desktop-versionen. På Windows skal du først tjekke de understøttede terminalmiljøer.

Før du starter, skal du have model-ID’et fra den aktuelle modelliste klar. Et model-ID er det navn, modeltjenesten bruger til at identificere en specifik model, og du skal kopiere det fuldstændige ID, når du bruger det.

Installation og første opstart

Hvis du vil have et grafisk vindue

Der er to dokumenterede installationsmetoder til macOS:

Download den fra installationssiden. Siden leverer macOS Silicon- og macOS Intel-versioner. Efter download skal du udpakke zip-filen og køre applikationen indeni.
Alternativt, brug Homebrew:

brew install --cask block-goose

Dette downloader den samme applikation og kan også håndtere opdateringer.

Hvis du bruger en Apple Mac M3, og der ikke vises noget vindue efter åbning af appen, skal du tjekke, om ~/.config er læsbar og skrivbar. goose bruger denne mappe til at skrive logfiler.

For Linux-desktop-versionen skal du downloade den fra installationssiden. De tilgængelige pakker er DEB til Ubuntu/Debian, RPM til RHEL/Fedora og Flatpak. På Debian eller Ubuntu skal du downloade DEB-filen, åbne mappen, hvor den blev gemt, køre sudo dpkg -i (filename).deb, og derefter åbne goose fra applikationsmenuen. Erstat (filename) med det faktiske filnavn.

For Windows-desktop-versionen skal du downloade den fra installationssiden, udpakke zip-filen og køre applikationen indeni.

Hvis du kun vil have terminalversionen

På macOS og Linux, kør:

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

For at springe interaktiv konfiguration over under installationen, tilføj CONFIGURE=false før bash:

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

På macOS kan du også køre:

brew install block-goose-cli

For at opdatere en installeret CLI, kør:

goose update

På Windows kræves et af følgende tre miljøer: Git Bash, som følger med Git til Windows og er markeret som anbefalet; MSYS2; eller PowerShell, der følger med Windows 10/11. I Git Bash og MSYS2 skal du bruge den samme download_cli.sh kommando vist ovenfor. I PowerShell skal du først downloade scriptet og derefter køre det:

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

Hvis du får at vide, at goose ikke er i PATH, skal du følge installationssiden og tilføje ~/.local/bin eller %USERPROFILE%\.local\bin til den aktuelle shell-konfiguration og derefter genåbne terminalen. PATH er et sæt mapper, som terminalen søger i efter programmer. Hvis installationsmappen ikke er inkluderet, kan du muligvis ikke køre et installeret program ved at indtaste dets navn direkte.

Pr. 2026-10-09 var CLI-versionen 1.54.0. Som standard placerer installationsscriptet programmet i ~/.local/bin. Du kan ændre denne mappe med GOOSE_BIN_DIR miljøvariablen. Hvis du ændrer den, vil scriptet ikke automatisk opdatere shell-konfigurationen, og terminalen vil rapportere, at mappen ikke er i PATH. Tilføj den mappe til PATH eller kør goose ved hjælp af dens fulde sti.

Første gang du bruger goose, vil den bede dig om at konfigurere en udbyder. Du kan springe de indbyggede udbydere over og tilføje en brugerdefineret udbyder som beskrevet i næste afsnit. I terminalen skal du navigere til den mappe, hvor du vil arbejde, og køre:

goose session

Hent forbindelsesværdier fra OmniProxy

Forbered adressen, nøglen og modelnavnet fra din egen OmniProxy-instans. Eksemplet med den brugerdefinerede udbyder bruger en base_url der slutter med /v1/chat/completions, så denne guide følger det samme 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

Kopiér det fuldstændige modelnavn fra den aktuelle OmniProxy-liste, inklusive eventuelle skråstreger. Pr. 2026-10-09 var to reference-ID’er i udbyderdokumentationen grok-4.7 til Grok og gpt-6-luna fra OpenAI-dokumentationen. gpt-6-luna understøtter Chat Completions; funktionskald i Chat Completions understøttes kun, når reasoning_effort er indstillet til none. Kopiér ikke et navn, der ikke optræder på listen.

Indtast værktøjskonfigurationen

En brugerdefineret udbyder kan bruge et OpenAI-, Anthropic- eller Ollama-kompatibelt format. Et kompatibelt format betyder, at værktøjet sender anmodninger i henhold til en fælles API-specifikation. Når du forbinder til OmniProxy, skal du vælge OpenAI Compatible.

Desktop

Klik på knappen i øverste venstre hjørne for at åbne sidepanelet.
Klik på Settings.
Klik på Models.
Klik på Configure providers.
Klik på Add Custom Provider nederst i vinduet.
For Provider Type, vælg OpenAI Compatible. Du kan indstille Display Name til OmniProxy. Indtast adressen fra det forrige afsnit i API URL. Hvis en nøgle er påkrævet, skal du vælge muligheden, der kræver en API Key, og indtaste din OmniProxy-nøgle. I Available Models skal du indtaste modelnavnene og adskille flere navne med kommaer.
Klik på Create Provider.

Desktop-versionen kan i øjeblikket ikke definere brugerdefinerede anmodningsheadere i dette vindue. Hvis du har brug for anmodningsheadere, skal du redigere konfigurationsfilen efter oprettelse af udbyderen.

Terminal

Kør:

goose configure

Vælg Custom Providers, vælg derefter Add A Custom Provider. For API Type, vælg OpenAI Compatible, og følg derefter vejledningen for at indtaste navn, API URL, om en nøgle er påkrævet, modelnavne, og om streaming-svar understøttes.

Ved manuel konfiguration på Windows, hvis nøgleringen rapporterer en fejl, siger installationsinstruktionerne, at man skal afvise at gemme nøglen i nøgleringen og bruge en miljøvariabel i stedet. Kør derefter goose configure igen. Nøgleringen er et lille sikkert lagringssystem, der bruges af operativsystemet til at gemme hemmeligheder.

Konfigurationsfil

De dokumenterede mapper er:

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

Du kan basere filen på det medfølgende eksempel. Erstat navn, adresse og modeller med dine egne værdier. Gem nøglen i miljøvariablen angivet af api_key_env; skriv ikke den rigtige nøgle ind i filen:

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

Behold en numerisk værdi for context_limit, som vist i eksemplet. Den faktiske kontekstgrænse afhænger af modellen og OmniProxy; behandl ikke eksempelnummeret som modellens officielle grænse. Før du bruger den, kør:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Efter indtastning af arbejdsmappen, kør:

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

Erstat værdien af --model med det fuldstændige ID fra listen. goose session har ikke en start underkommando. Du kan også indstille --provider og --model gennem GOOSE_PROVIDER og GOOSE_MODEL miljøvariabler. Selvom gatewayen ikke validerer nøgler, OMNIPROXY_API_KEY skal stadig have en værdi. Det kan være en pladsholderstreng, der kun bruges på din lokale computer. Denne konfiguration læste med succes en fil under test den 2026-10-09.

Vindue

Indstillinger

Indstillinger i sidepanelet
Models-side
Tilføj brugerdefineret udbyder

Terminal

goose configure

Vælg brugerdefinerede udbydere
Vælg derefter tilføj
Vælg OpenAI Compatible som typen

Fil

custom_providers

På macOS og Linux er den under ~/.config
På Windows er den under APPDATA
Indstil base_url i henhold til det officielle eksempel

Alle tre metoder opretter den samme type konfiguration. Vælg OpenAI Compatible som udbydertype.

Bekræft med en rigtig opgave

Åbn en mappe, der indeholder en almindelig fil, og kør goose session som vist i det forrige afsnit. Bed den om at læse den første linje i en fil, du angiver. Den bør returnere filindholdet i stedet for kun at sige, at konfigurationen blev gemt.

For at læse filer eller udføre kommandoer har sessionen brug for Developer-udvidelsen. Developer-udvidelsen er et værktøjsmodul, der lader goose arbejde med lokale filer og kommandoer. Den er generelt inkluderet i standardkonfigurationen. Hvis goose siger, at den ikke har nogen filværktøjer, skal du tilføje følgende til kommandoen:

--with-builtin developer

Tilføj ikke også --no-profile, fordi den indstilling deaktiverer standardudvidelserne.

Under test den 2026-10-09 læste goose 1.54.0 med succes den første linje i den angivne fil. Det første svar kan tage omkring et minut.

Tjek derefter OmniProxy-anmodningslogfilerne for at bekræfte kilden og modelnavnet.

Start

En session åbner

goose session
Udbyderen er den, der lige blev tilføjet
Modelnavnet er på listen

Opgave

Den fuldførte faktisk opgaven

For eksempel, list den aktuelle mappe
Gennemgå dens svar
Stol ikke kun på en succesfuld lagring

Logfiler

Synlig i gatewayen

Brug adressen fra dokumentationseksemplet
Læg ikke nøglen i depotet
Model-ID'et matcher listen

Efter lagring af udbyderen skal du bekræfte den med en rigtig session.

Almindelige fejl

goose kommandoen kan ikke findes: Tilføj installationsmappen til PATH som beskrevet på installationssiden, og genåbn derefter terminalen.
Intet vindue vises i desktop-versionen på en M3 Mac: Tjek læse- og skrivetilladelser for ~/.config.
Nøgleringen fejler: Gem ikke nøglen i nøgleringen; brug en miljøvariabel i stedet.
Modellen er ikke på listen: I desktop-versionen skal du vælge Use custom model og indtaste modelnavnet manuelt. goose configure kan ikke acceptere et brugerdefineret modelnavn. Til terminalbrug skal du skifte til desktop-versionen eller redigere GOOSE_MODEL direkte i konfigurationen.
Adressen kan ikke nås: Bekræft, at API URL slutter på /v1/chat/completions, som i eksemplet, og at OmniProxy kører.
Den siger, at den ikke kan læse filer: Tilføj Developer-udvidelsen og brug ikke --no-profile.
Den returnerer unsupported Responses role: system: Adressen er normalt korrekt. Skift til et andet fuldstændigt ID fra modellisten.

Officielle referencer

For installation, se Install goose. For brugerdefinerede udbydere, se goose providers. For model-ID’erne brugt i eksemplerne, se xAI models page og GPT-6 Luna.

Erstat alle pladsholdere med værdier fra din egen OmniProxy-konfiguration. Publicér aldrig en rigtig nøgle.

Et gemt resultat eller HTTP 200 alene beviser ikke fuld agentkompatibilitet. Tjek kilden og modellen i OmniProxys anmodningspost.

Officielle kilder · goose ↗