Installere goose og konfigurere en tilpasset leverandør

goose er en AI-assistent for generelle formål som kjører på datamaskinen din. I tillegg til koding kan den håndtere forskning, skriving, automatisering og datastrukturering. Du kan bruke den via skrivebordsappen, terminalen eller API-et, og skrivebords- og terminalversjonene deler samme modellkonfigurasjon. Den er egnet for repeterende kodeoppgaver og kan også koble til GitHub, databaser og filer.

Før du starter

goose tilbyr to installasjonsalternativer: Desktop og CLI. Desktop er den grafiske versjonen med et vindu, mens CLI brukes ved å skrive inn kommandoer i en terminal. Begge deler samme kjernekonfigurasjon, inkludert leverandør og modell. En leverandør er tilkoblingskonfigurasjonen som forteller goose hvilken modelltjeneste som skal brukes.

Vil ha et vindu

goose Desktop

Last ned zip-filen på macOS
Eller bruk brew cask
Bruk installasjonspakken på Linux

Kun terminal

goose CLI

download_cli.sh
Eller Homebrew CLI
Kjør deretter goose session

Windows

Velg et miljø først

Git Bash eller MSYS2
Du kan også bruke PowerShell
Hvis kommandoen ikke finnes, legg den til i PATH

På macOS kan du installere den ved å laste ned appen eller bruke Homebrew. På Linux, bruk distribusjonens pakke for skrivebordsversjonen. På Windows, sjekk først de støttede terminalmiljøene.

Før du starter, ha modell-ID-en fra den gjeldende modellisten klar. En modell-ID er navnet modelltjenesten bruker for å identifisere en spesifikk modell, og du må kopiere hele ID-en når du bruker den.

Installer og start for første gang

Hvis du vil ha et grafisk vindu

Det finnes to dokumenterte installasjonsmetoder for macOS:

Last den ned fra installasjonssiden. Siden tilbyr macOS Silicon- og macOS Intel-versjoner. Etter nedlasting, pakk ut zip-filen og kjør applikasjonen inni.
Alternativt, bruk Homebrew:

brew install --cask block-goose

Dette laster ned den samme applikasjonen og kan også håndtere oppdateringer.

Hvis du bruker en Apple Mac M3 og ingen vinduer vises etter at du har åpnet appen, sjekk om ~/.config er lesbar og skrivbar. goose bruker denne katalogen til å skrive logger.

For Linux-skrivebordsversjonen, last den ned fra installasjonssiden. De tilgjengelige pakkene er DEB for Ubuntu/Debian, RPM for RHEL/Fedora og Flatpak. På Debian eller Ubuntu, last ned DEB-filen, åpne katalogen der den ble lagret, kjør sudo dpkg -i (filename).deb, og åpne deretter goose fra applikasjonsmenyen. Erstatt (filename) med det faktiske filnavnet.

For Windows-skrivebordsversjonen, last den ned fra installasjonssiden, pakk ut zip-filen og kjør applikasjonen inni.

Hvis du bare vil ha terminalversjonen

På macOS og Linux, kjør:

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

For å hoppe over interaktiv konfigurasjon under installasjon, legg til 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å kjøre:

brew install block-goose-cli

For å oppdatere en installert CLI, kjør:

goose update

På Windows kreves ett av følgende tre miljøer: Git Bash, som følger med Git for Windows og er merket som anbefalt; MSYS2; eller PowerShell som følger med Windows 10/11. I Git Bash og MSYS2, bruk den samme download_cli.sh kommandoen vist ovenfor. I PowerShell, last ned skriptet først og kjør det deretter:

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 beskjed om at goose ikke er i PATH, følg installasjonssiden og legg til ~/.local/bin eller %USERPROFILE%\.local\bin til den gjeldende skallkonfigurasjonen, og åpne deretter terminalen på nytt. PATH er et sett med kataloger som terminalen søker i etter programmer. Hvis installasjonskatalogen ikke er inkludert, kan det hende du ikke kan kjøre et installert program ved å skrive inn navnet direkte.

Per 09.10.2026 var CLI-versjonen 1.54.0. Som standard plasserer installasjonsskriptet programmet i ~/.local/bin. Du kan endre denne katalogen med GOOSE_BIN_DIR miljøvariabelen. Hvis du endrer den, vil ikke skriptet automatisk oppdatere skallkonfigurasjonen, og terminalen vil rapportere at katalogen ikke er i PATH. Legg til den katalogen i PATH eller kjør goose ved å bruke hele banen.

Første gang du bruker goose, vil den be deg om å konfigurere en leverandør. Du kan hoppe over de innebygde leverandørene og legge til en tilpasset leverandør som beskrevet i neste del. I terminalen, naviger til katalogen der du vil jobbe og kjør:

goose session

Hent tilkoblingsverdier fra OmniProxy

Klargjør adressen, nøkkelen og modellnavnet fra din egen OmniProxy-instans. Eksempelet med tilpasset leverandør bruker en base_url som slutter på /v1/chat/completions, så denne guiden følger 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

Kopier hele modellnavnet fra den gjeldende OmniProxy-listen, inkludert eventuelle skråstreker. Per 09.10.2026 var to referanse-ID-er i leverandørdokumentasjonen grok-4.7 for Grok og gpt-6-luna fra OpenAI-dokumentasjonen. gpt-6-luna støtter Chat Completions; funksjonskall i Chat Completions støttes bare når reasoning_effort er satt til none. Ikke kopier et navn som ikke vises i listen.

Angi verktøykonfigurasjon

En tilpasset leverandør kan bruke et OpenAI-, Anthropic- eller Ollama-kompatibelt format. Et kompatibelt format betyr at verktøyet sender forespørsler i henhold til en felles API-spesifikasjon. Når du kobler til OmniProxy, velg OpenAI Compatible.

Desktop

Klikk på knappen i øvre venstre hjørne for å åpne sidefeltet.
Klikk Settings.
Klikk Models.
Klikk Configure providers.
Klikk Add Custom Provider nederst i vinduet.
For Provider Type, velg OpenAI Compatible. Du kan sette Display Name til OmniProxy. Skriv inn adressen fra forrige del i API URL. Hvis en nøkkel er påkrevd, velg alternativet som krever en API Key og skriv inn OmniProxy-nøkkelen din. I Available Models, skriv inn modellnavnene, og separer flere navn med komma.
Klikk Create Provider.

Skrivebordsversjonen kan for øyeblikket ikke definere egendefinerte forespørselshoder i dette vinduet. Hvis du trenger forespørselshoder, rediger konfigurasjonsfilen etter at du har opprettet leverandøren.

Terminal

Kjør:

goose configure

Velg Custom Providers, velg deretter Add A Custom Provider. For API Type, velg OpenAI Compatible, og følg deretter instruksjonene for å skrive inn navn, API URL, om en nøkkel er påkrevd, modellnavn og om strømmende svar støttes.

Når du konfigurerer manuelt på Windows, hvis nøkkelringen rapporterer en feil, sier installasjonsinstruksjonene at du skal takke nei til å lagre nøkkelen i nøkkelringen og bruke en miljøvariabel i stedet. Kjør deretter goose configure igjen. Nøkkelringen er et lite sikkert lagringssystem som brukes av operativsystemet til å lagre hemmeligheter.

Konfigurasjonsfil

De dokumenterte katalogene er:

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

Du kan basere filen på det oppgitte eksempelet. Erstatt navn, adresse og modeller med dine egne verdier. Lagre nøkkelen i miljøvariabelen spesifisert av api_key_env; ikke skriv den ekte nøkkelen inn 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 verdi for context_limit, som vist i eksempelet. Den faktiske kontekstgrensen avhenger av modellen og OmniProxy; ikke behandle eksempelnummeret som modellens offisielle grense. Før du bruker den, kjør:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Etter at du har gått inn i arbeidskatalogen, kjør:

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

Erstatt verdien av --model med den fullstendige ID-en fra listen. goose session har ikke en start underkommando. Du kan også sette --provider og --model gjennom GOOSE_PROVIDER og GOOSE_MODEL miljøvariablene. Selv om gatewayen ikke validerer nøkler, OMNIPROXY_API_KEY må fortsatt ha en verdi. Det kan være en plassholderstreng som kun brukes på din lokale datamaskin. Denne konfigurasjonen leste en fil vellykket under testing 09.10.2026.

Vindu

Innstillinger

Innstillinger i sidefeltet
Modellsiden
Legg til tilpasset leverandør

Terminal

goose configure

Velg tilpassede leverandører
Velg deretter legg til
Velg OpenAI Compatible som type

Fil

custom_providers

På macOS og Linux er den under ~/.config
På Windows er den under APPDATA
Sett base_url i henhold til det offisielle eksempelet

Alle tre metodene oppretter samme type konfigurasjon. Velg OpenAI Compatible som leverandørtype.

Bekreft med en ekte oppgave

Åpne en katalog som inneholder en vanlig fil og kjør goose session som vist i forrige del. Be den lese den første linjen i en fil du spesifiserer. Den skal returnere filinnholdet i stedet for bare å si at konfigurasjonen ble lagret.

For å lese filer eller utføre kommandoer trenger økten Developer-utvidelsen. Developer-utvidelsen er en verktøymodul som lar goose jobbe med lokale filer og kommandoer. Den er vanligvis inkludert i standardkonfigurasjonen. Hvis goose sier at den ikke har noen filverktøy, legg til følgende i kommandoen:

--with-builtin developer

Ikke legg til --no-profileogså, fordi det alternativet deaktiverer standardutvidelsene.

Under testing 09.10.2026 leste goose 1.54.0 den første linjen i den spesifiserte filen. Det første svaret kan ta rundt ett minutt.

Sjekk deretter OmniProxy-forespørselsloggene for å bekrefte kilden og modellnavnet.

Start

En økt åpnes

goose session
Leverandøren er den som nettopp ble lagt til
Modellnavnet er i listen

Oppgave

Den fullførte faktisk oppgaven

For eksempel, list opp den gjeldende katalogen
Gjennomgå svaret
Ikke stol bare på en vellykket lagring

Logger

Synlig i gatewayen

Bruk adressen fra dokumentasjonseksempelet
Ikke legg nøkkelen i depotet
Modell-ID-en samsvarer med listen

Etter at du har lagret leverandøren, bekreft den med en ekte økt.

Vanlige feil

goose kommandoen kan ikke finnes: Legg til installasjonskatalogen i PATH som beskrevet på installasjonssiden, og åpne deretter terminalen på nytt.
Ingen vinduer vises i skrivebordsversjonen på en M3 Mac: Sjekk lese- og skrivetilgang for ~/.config.
Nøkkelringen mislykkes: Ikke lagre nøkkelen i nøkkelringen; bruk en miljøvariabel i stedet.
Modellen er ikke i listen: I skrivebordsversjonen, velg Use custom model og skriv inn modellnavnet manuelt. goose configure kan ikke godta et tilpasset modellnavn. For terminalbruk, bytt til skrivebordsversjonen eller rediger GOOSE_MODEL direkte i konfigurasjonen.
Adressen kan ikke nås: Bekreft at API URL slutter på /v1/chat/completions, som i eksempelet, og at OmniProxy kjører.
Den sier at den ikke kan lese filer: Legg til Developer-utvidelsen og ikke bruk --no-profile.
Den returnerer unsupported Responses role: system: Adressen er vanligvis riktig. Bytt til en annen fullstendig ID fra modellisten.

Offisielle referanser

For installasjon, se Install goose. For tilpassede leverandører, se goose providers. For modell-ID-ene som brukes i eksemplene, se xAI-modell-siden og GPT-6 Luna.

Erstatt alle plassholdere med verdier fra din egen OmniProxy-konfigurasjon. Publisér aldri en ekte nøkkel.

Et lagret resultat eller HTTP 200 alene beviser ikke full kompatibilitet med en agent. Sjekk kilde og modell i OmniProxy sin kalllogg.

Offisielle kilder · goose ↗