Installera goose och konfigurera en anpassad leverantör

goose är en AI-assistent för allmänna ändamål som körs på din dator. Utöver kodning kan den hantera forskning, skrivande, automatisering och dataorganisering. Du kan använda den via skrivbordsappen, terminalen eller API:et, och skrivbords- och terminalversionerna delar samma modellkonfiguration. Den är lämplig för repetitiva kodningsuppgifter och kan även ansluta till GitHub, databaser och filer.

Innan du börjar

goose erbjuder två installationsalternativ: Desktop och CLI. Desktop är den grafiska versionen med ett fönster, medan CLI används genom att skriva kommandon i en terminal. Båda delar samma kärnkonfiguration, inklusive leverantör och modell. En leverantör är anslutningskonfigurationen som talar om för goose vilken modelltjänst som ska användas.

Vill ha ett fönster

goose Desktop

Ladda ner zip-filen på macOS
Eller använd brew cask
Använd installationspaketet på Linux

Endast terminal

goose CLI

download_cli.sh
Eller Homebrew CLI
Kör sedan goose session

Windows

Välj en miljö först

Git Bash eller MSYS2
Du kan även använda PowerShell
Om kommandot inte hittas, lägg till det i PATH

På macOS kan du installera den genom att ladda ner appen eller använda Homebrew. På Linux, använd din distributions paket för skrivbordsversionen. På Windows, kontrollera först de terminalmiljöer som stöds.

Innan du börjar, ha modell-ID:t från den aktuella modellistan redo. Ett modell-ID är namnet som modelltjänsten använder för att identifiera en specifik modell, och du måste kopiera det fullständiga ID:t när du använder det.

Installation och första start

Om du vill ha ett grafiskt fönster

Det finns två dokumenterade installationsmetoder för macOS:

Ladda ner den från installationssidan. Sidan tillhandahåller versioner för macOS Silicon och macOS Intel. Efter nedladdning, extrahera zip-filen och kör applikationen inuti.
Alternativt, använd Homebrew:

brew install --cask block-goose

Detta laddar ner samma applikation och kan även hantera uppdateringar.

Om du använder en Apple Mac M3 och inget fönster visas efter att du öppnat appen, kontrollera om ~/.config är läs- och skrivbar. goose använder denna katalog för att skriva loggar.

För Linux-skrivbordsversionen, ladda ner den från installationssidan. De tillgängliga paketen är DEB för Ubuntu/Debian, RPM för RHEL/Fedora och Flatpak. På Debian eller Ubuntu, ladda ner DEB-filen, öppna katalogen där den sparades, kör sudo dpkg -i (filename).deb och öppna sedan goose från applikationsmenyn. Ersätt (filename) med det faktiska filnamnet.

För Windows-skrivbordsversionen, ladda ner den från installationssidan, extrahera zip-filen och kör applikationen inuti.

Om du bara vill ha terminalversionen

På macOS och Linux, kör:

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

För att hoppa över interaktiv konfiguration under installationen, lägg till CONFIGURE=false före bash:

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

På macOS kan du även köra:

brew install block-goose-cli

För att uppdatera en installerad CLI, kör:

goose update

På Windows krävs en av följande tre miljöer: Git Bash, som ingår i Git for Windows och är markerad som rekommenderad; MSYS2; eller PowerShell som ingår i Windows 10/11. I Git Bash och MSYS2, använd samma download_cli.sh-kommando som visas ovan. I PowerShell, ladda ner skriptet först och kör det sedan:

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

Om du får veta att goose inte finns i PATH, följ installationssidan och lägg till ~/.local/bin eller %USERPROFILE%\.local\bin i den aktuella skal-konfigurationen, starta sedan om terminalen. PATH är en uppsättning kataloger som terminalen söker efter program i. Om installationskatalogen inte inkluderas kan du vara oförmögen att köra ett installerat program genom att ange dess namn direkt.

Per 2026-10-09 var CLI-versionen 1.54.0. Som standard placerar installationsskriptet programmet i ~/.local/bin. Du kan ändra denna katalog med miljövariabeln GOOSE_BIN_DIR. Om du ändrar den kommer skriptet inte automatiskt att uppdatera skal-konfigurationen, och terminalen kommer att rapportera att katalogen inte finns i PATH. Lägg till den katalogen i PATH eller kör goose med dess fullständiga sökväg.

Första gången du använder goose kommer den att be dig konfigurera en leverantör. Du kan hoppa över de inbyggda leverantörerna och lägga till en anpassad leverantör enligt beskrivningen i nästa avsnitt. I terminalen, navigera till katalogen där du vill arbeta och kör:

goose session

Hämta anslutningsvärden från OmniProxy

Förbered adress, nyckel och modellnamn från din egen OmniProxy-instans. Exemplet med anpassad leverantör använder en base_url som slutar på /v1/chat/completions, så denna guide följer samma 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

Kopiera det fullständiga modellnamnet från den aktuella OmniProxy-listan, inklusive eventuella snedstreck. Per 2026-10-09 var två referens-ID:n i leverantörsdokumentationen grok-4.7 för Grok och gpt-6-luna från OpenAI-dokumentationen. gpt-6-luna stöder Chat Completions; funktionsanrop i Chat Completions stöds endast när reasoning_effort är inställd på none. Kopiera inte ett namn som inte visas i listan.

Ange verktygskonfigurationen

En anpassad leverantör kan använda ett OpenAI-, Anthropic- eller Ollama-kompatibelt format. Ett kompatibelt format innebär att verktyget skickar begäranden enligt en gemensam API-specifikation. När du ansluter till OmniProxy, välj OpenAI Compatible.

Desktop

Klicka på knappen i det övre vänstra hörnet för att öppna sidofältet.
Klicka på Settings.
Klicka på Models.
Klicka på Configure providers.
Klicka på Add Custom Provider längst ner i fönstret.
För Provider Type, välj OpenAI Compatible. Du kan ställa in Display Name till OmniProxy. Ange adressen från föregående avsnitt i API URL. Om en nyckel krävs, välj alternativet som kräver en API Key och ange din OmniProxy-nyckel. I Available Models, ange modellnamnen och separera flera namn med kommatecken.
Klicka på Create Provider.

Skrivbordsversionen kan för närvarande inte definiera anpassade begärandehuvuden i detta fönster. Om du behöver begärandehuvuden, redigera konfigurationsfilen efter att ha skapat leverantören.

Terminal

Kör:

goose configure

Välj Custom Providers, välj sedan Add A Custom Provider. För API Type, välj OpenAI Compatible, följ sedan anvisningarna för att ange namn, API URL, om en nyckel krävs, modellnamn och om streaming-svar stöds.

Vid manuell konfiguration på Windows, om nyckelringen rapporterar ett fel, säger installationsinstruktionerna att du ska tacka nej till att spara nyckeln i nyckelringen och använda en miljövariabel istället. Kör sedan goose configure igen. Nyckelringen är ett litet säkert lagringssystem som används av operativsystemet för att lagra hemligheter.

Konfigurationsfil

De dokumenterade katalogerna är:

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

Du kan basera filen på det tillhandahållna exemplet. Ersätt namn, adress och modeller med dina egna värden. Lagra nyckeln i miljövariabeln som anges av api_key_env; skriv inte in den riktiga nyckeln 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
}

Behåll ett numeriskt värde för context_limit, som visas i exemplet. Den faktiska kontextgränsen beror på modellen och OmniProxy; behandla inte exempelnumret som modellens officiella gräns. Innan du använder den, kör:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Efter att ha angett arbetskatalogen, kör:

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

Ersätt värdet för --model med det fullständiga ID:t från listan. goose session har inte ett start-underkommando. Du kan även ställa in --provider och --model via miljövariablerna GOOSE_PROVIDER och GOOSE_MODEL. Även om gatewayen inte validerar nycklar måste OMNIPROXY_API_KEY fortfarande ha ett värde. Det kan vara en platshållarsträng som endast används på din lokala dator. Denna konfiguration läste framgångsrikt en fil vid testning den 2026-10-09.

Fönster

Settings

Settings i sidofältet
Models-sidan
Add Custom Provider

Terminal

goose configure

Välj Custom Providers
Välj sedan add
Välj OpenAI Compatible som typ

Fil

custom_providers

På macOS och Linux finns den under ~/.config
På Windows finns den under APPDATA
Ställ in base_url enligt det officiella exemplet

Alla tre metoder skapar samma typ av konfiguration. Välj OpenAI Compatible som leverantörstyp.

Verifiera med en verklig uppgift

Öppna en katalog som innehåller en vanlig fil och kör goose session som visas i föregående avsnitt. Be den läsa den första raden i en fil du anger. Den bör returnera filinnehållet istället för att bara säga att konfigurationen sparades.

För att läsa filer eller köra kommandon behöver sessionen Developer-tillägget. Developer-tillägget är en verktygsmodul som låter goose arbeta med lokala filer och kommandon. Det ingår vanligtvis i standardkonfigurationen. Om goose säger att den inte har några filverktyg, lägg till följande i kommandot:

--with-builtin developer

Lägg inte till --no-profile också, eftersom det alternativet inaktiverar standardtilläggen.

Vid testning den 2026-10-09 läste goose 1.54.0 framgångsrikt den första raden i den angivna filen. Det första svaret kan ta cirka en minut.

Kontrollera sedan OmniProxys begärandeloggar för att bekräfta källan och modellnamnet.

Starta

En session öppnas

goose session
Leverantören är den som precis lades till
Modellnamnet finns i listan

Uppgift

Den slutförde faktiskt uppgiften

Lista till exempel den aktuella katalogen
Granska dess svar
Lita inte bara på en lyckad sparning

Loggar

Synliga i gatewayen

Använd adressen från dokumentationsexemplet
Placera inte nyckeln i arkivet
Modell-ID:t matchar listan

Efter att ha sparat leverantören, bekräfta den med en verklig session.

Vanliga fel

Kommandot goose kan inte hittas: Lägg till installationskatalogen i PATH enligt beskrivningen på installationssidan, starta sedan om terminalen.
Inget fönster visas i skrivbordsversionen på en M3 Mac: Kontrollera läs- och skrivbehörigheter för ~/.config.
Nyckelringen misslyckas: Spara inte nyckeln i nyckelringen; använd en miljövariabel istället.
Modellen finns inte i listan: I skrivbordsversionen, välj Use custom model och ange modellnamnet manuellt. goose configure kan inte acceptera ett anpassat modellnamn. För terminalanvändning, växla till skrivbordsversionen eller redigera GOOSE_MODEL direkt i konfigurationen.
Adressen kan inte nås: Bekräfta att API URL slutar på /v1/chat/completions, som i exemplet, och att OmniProxy körs.
Den säger att den inte kan läsa filer: Lägg till Developer-tillägget och använd inte --no-profile.
Den returnerar unsupported Responses role: system: Adressen är vanligtvis korrekt. Växla till ett annat fullständigt ID från modellistan.

Officiella referenser

För installation, se Install goose. För anpassade leverantörer, se goose providers. För modell-ID:n som används i exemplen, se xAI models page och GPT-6 Luna.

Ersätt varje platshållare med värden från din egen OmniProxy-konfiguration. Publicera aldrig en riktig nyckel.

Ett sparat resultat eller HTTP 200 ensamt bevisar inte fullständig agentkompatibilitet. Kontrollera källa och modell i OmniProxys anropslogg.

Officiella källor · goose ↗