Namestitev goose in konfiguracija ponudnika po meri

goose je pomočnik AI za splošno uporabo, ki deluje v vašem računalniku. Poleg kodiranja lahko obravnava raziskovanje, pisanje, avtomatizacijo in organizacijo podatkov. Uporabljate ga lahko prek namizne aplikacije, terminala ali API-ja, namizna in terminalska različica pa si delita isto konfiguracijo modela. Primeren je za ponavljajoče se naloge kodiranja, poveže pa se lahko tudi z GitHubom, bazami podatkov in datotekami.

Preden začnete

goose ponuja dve možnosti namestitve: Desktop in CLI. Desktop je grafična različica z oknom, medtem ko se CLI uporablja z vnosom ukazov v terminal. Obe si delita isto osnovno konfiguracijo, vključno s ponudnikom (Provider) in modelom. Ponudnik je konfiguracija povezave, ki gooseu pove, katero storitev modela naj uporabi.

Želite okno

goose Desktop

• Prenesite zip na macOS
• Ali uporabite brew cask
• Uporabite namestitveni paket v Linuxu

Samo terminal

goose CLI

• download_cli.sh
• Ali Homebrew CLI
• Nato zaženite goose session

Windows

Najprej izberite okolje

• Git Bash ali MSYS2
• Uporabite lahko tudi PowerShell
• Če ukaz ni najden, ga dodajte v PATH

Pred začetkom imejte pripravljen ID modela s trenutnega seznama modelov. ID modela je ime, ki ga storitev modela uporablja za identifikacijo določenega modela, in pri uporabi morate kopirati celoten ID.

Namestitev in prvi zagon

Če želite grafično okno

Za macOS sta dokumentirani dve metodi namestitve:

• Prenesite ga s strani za namestitev. Stran ponuja različici macOS Silicon in macOS Intel. Po prenosu izvlecite datoteko zip in zaženite aplikacijo v njej.
• Druga možnost je uporaba Homebrew:

brew install --cask block-goose

To prenese isto aplikacijo in lahko upravlja tudi posodobitve.

Če uporabljate Apple Mac M3 in se po odprtju aplikacije ne prikaže nobeno okno, preverite, ali je ~/.config berljiv in zapisljiv. goose uporablja ta imenik za pisanje dnevnikov.

Za namizno različico Linuxa jo prenesite s strani za namestitev. Razpoložljivi paketi so DEB za Ubuntu/Debian, RPM za RHEL/Fedora in Flatpak. V Debianu ali Ubuntuju prenesite datoteko DEB, odprite imenik, kamor je bila shranjena, zaženite sudo dpkg -i (filename).deb, nato pa odprite goose iz menija aplikacij. Zamenjajte (filename) z dejanskim imenom datoteke.

Za namizno različico Windows jo prenesite s strani za namestitev, izvlecite datoteko zip in zaženite aplikacijo v njej.

Če želite samo terminalsko različico

Na sistemih macOS in Linux zaženite:

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

Če želite med namestitvijo preskočiti interaktivno konfiguracijo, dodajte CONFIGURE=false pred bash:

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

Na macOS lahko zaženete tudi:

brew install block-goose-cli

Za posodobitev nameščenega CLI zaženite:

goose update

V sistemu Windows je potrebno eno od naslednjih treh okolij: Git Bash, ki je vključen v Git za Windows in označen kot priporočen; MSYS2; ali PowerShell, vključen v Windows 10/11. V Git Bash in MSYS2 uporabite isti download_cli.sh ukaz, prikazan zgoraj. V PowerShell najprej prenesite skript in ga nato zaženite:

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

Če vam sporočijo, da goose ni v PATH, sledite strani za namestitev in dodajte ~/.local/bin ali %USERPROFILE%\.local\bin v trenutno konfiguracijo lupine, nato ponovno odprite terminal. PATH je nabor imenikov, v katerih terminal išče programe. Če namestitveni imenik ni vključen, morda ne boste mogli zagnati nameščenega programa z neposrednim vnosom njegovega imena.

Na dan 9. 10. 2026 je bila različica CLI 1.54.0. Namestitveni skript privzeto postavi program v ~/.local/bin. Ta imenik lahko spremenite z okoljsko spremenljivko GOOSE_BIN_DIR . Če ga spremenite, skript ne bo samodejno posodobil konfiguracije lupine in terminal bo poročal, da imenik ni v PATH. Dodajte ta imenik v PATH ali zaženite goose z uporabo njegove celotne poti.

Ko prvič uporabite goose, vas bo pozval k konfiguraciji ponudnika. Preskočite lahko vgrajene ponudnike in dodate ponudnika po meri, kot je opisano v naslednjem razdelku. V terminalu se pomaknite do imenika, kjer želite delati, in zaženite:

goose session

Pridobitev vrednosti povezave iz OmniProxy

Pripravite naslov, ključ in ime modela iz lastnega primerka OmniProxy. Primer ponudnika po meri uporablja base_url ki se konča z /v1/chat/completions, zato ta vodnik sledi istemu formatu:

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

Kopirajte celotno ime modela s trenutnega seznama OmniProxy, vključno s poševnicami. Na dan 9. 10. 2026 sta bila dva referenčna ID-ja v dokumentaciji ponudnika grok-4.7 za Grok in gpt-6-luna iz dokumentacije OpenAI. gpt-6-luna podpira Chat Completions; klicanje funkcij v Chat Completions je podprto le, ko je reasoning_effort nastavljeno na none. Ne kopirajte imena, ki se ne pojavi na seznamu.

Vnos konfiguracije orodja

Ponudnik po meri lahko uporablja format, združljiv z OpenAI, Anthropic ali Ollama. Združljiv format pomeni, da orodje pošilja zahteve v skladu s skupno specifikacijo API-ja. Pri povezovanju z OmniProxy izberite OpenAI Compatible.

Desktop

1. Kliknite gumb v zgornjem levem kotu, da odprete stransko vrstico.
2. Kliknite Settings.
3. Kliknite Models.
4. Kliknite Configure providers.
5. Na dnu okna kliknite Add Custom Provider.
6. Za vrsto ponudnika (Provider Type) izberite OpenAI Compatible. Ime za prikaz (Display Name) lahko nastavite na OmniProxy. V API URL vnesite naslov iz prejšnjega razdelka. Če je potreben ključ, izberite možnost, ki zahteva API ključ, in vnesite svoj ključ OmniProxy. V Available Models vnesite imena modelov, pri čemer več imen ločite z vejicami.
7. Kliknite Create Provider.

Namizna različica trenutno v tem oknu ne more definirati glav zahtev po meri. Če potrebujete glave zahtev, uredite konfiguracijsko datoteko po ustvarjanju ponudnika.

Terminal

Zaženite:

goose configure

Izberite Custom Providers, nato izberite Add A Custom Provider. Za vrsto API-ja (API Type) izberite OpenAI Compatible, nato sledite pozivom za vnos imena, URL-ja API-ja, ali je potreben ključ, imen modelov in ali so podprti pretočni odzivi.

Pri ročni konfiguraciji v sistemu Windows, če obesek za ključe (keychain) poroča o napaki, navodila za namestitev pravijo, naj zavrnete shranjevanje ključa v obesku za ključe in namesto tega uporabite okoljsko spremenljivko. Nato ponovno zaženite goose configure . Obesek za ključe je majhen varen sistem za shranjevanje, ki ga operacijski sistem uporablja za shranjevanje skrivnosti.

Konfiguracijska datoteka

Dokumentirani imeniki so:

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

Datoteka lahko temelji na podanem primeru. Zamenjajte ime, naslov in modele s svojimi vrednostmi. Ključ shranite v okoljsko spremenljivko, določeno z api_key_env; ne zapisujte pravega ključa v datoteko:

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

Ohranite številsko vrednost za context_limit, kot je prikazano v primeru. Dejanska omejitev konteksta je odvisna od modela in OmniProxy; primera številke ne obravnavajte kot uradne omejitve modela. Pred uporabo zaženite:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Po vstopu v delovni imenik zaženite:

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

Zamenjajte vrednost --model s celotnim ID-jem s seznama. goose session nima podukaza start . Nastavite lahko tudi --provider in --model prek GOOSE_PROVIDER in GOOSE_MODEL okoljskih spremenljivk. Tudi če prehod ne preverja ključev, OMNIPROXY_API_KEY mora še vedno imeti vrednost. To je lahko nadomestni niz, ki se uporablja samo v vašem lokalnem računalniku. Ta konfiguracija je pri testiranju 9. 10. 2026 uspešno prebrala datoteko.

Okno

Nastavitve

• Nastavitve v stranski vrstici
• Stran Models
• Dodaj ponudnika po meri

Terminal

goose configure

• Izberite Custom Providers
• Nato izberite dodaj
• Kot vrsto izberite OpenAI Compatible

Datoteka

custom_providers

• Na macOS in Linux je pod ~/.config
• V sistemu Windows je pod APPDATA
• Nastavite base_url v skladu z uradnim primerom

Preverjanje s pravo nalogo

Odprite imenik, ki vsebuje običajno datoteko, in zaženite goose session kot je prikazano v prejšnjem razdelku. Prosite ga, naj prebere prvo vrstico datoteke, ki jo določite. Vrniti mora vsebino datoteke, namesto da samo reče, da je bila konfiguracija shranjena.

Za branje datotek ali izvajanje ukazov seja potrebuje razširitev Developer. Razširitev Developer je modul orodij, ki gooseu omogoča delo z lokalnimi datotekami in ukazi. Na splošno je vključena v privzeto konfiguracijo. Če goose reče, da nima orodij za datoteke, ukazu dodajte naslednje:

--with-builtin developer

Ne dodajajte tudi --no-profile, ker ta možnost onemogoči privzete razširitve.

Pri testiranju 9. 10. 2026 je goose 1.54.0 uspešno prebral prvo vrstico določene datoteke. Prvi odziv lahko traja približno eno minuto.

Nato preverite dnevnike zahtev OmniProxy, da potrdite vir in ime modela.

Zagon

Odpre se seja

• goose session
• Ponudnik je tisti, ki ste ga pravkar dodali
• Ime modela je na seznamu

Naloga

Dejansko je dokončal nalogo

• Na primer, navedite trenutni imenik
• Preglejte njegov odziv
• Ne zanašajte se samo na uspešno shranjevanje

Dnevniki

Vidno v prehodu

• Uporabite naslov iz primera v dokumentaciji
• Ne postavljajte ključa v repozitorij
• ID modela se ujema s seznamom

Pogoste napake

• Ukaza goose ni mogoče najti: Dodajte namestitveni imenik v PATH, kot je opisano na strani za namestitev, nato ponovno odprite terminal.
• V namizni različici na M3 Mac se ne prikaže nobeno okno: Preverite dovoljenja za branje in pisanje za ~/.config.
• Obesek za ključe ne deluje: Ne shranjujte ključa v obesek za ključe; namesto tega uporabite okoljsko spremenljivko.
• Model ni na seznamu: V namizni različici izberite Use custom model in ročno vnesite ime modela. goose configure ne more sprejeti imena modela po meri. Za uporabo v terminalu preklopite na namizno različico ali uredite GOOSE_MODEL neposredno v konfiguraciji.
• Naslov ni dosegljiv: Potrdite, da se URL API-ja konča z /v1/chat/completions, kot v primeru, in da OmniProxy deluje.
• Pravi, da ne more brati datotek: Dodajte razširitev Developer in ne uporabljajte --no-profile.
• Vrne unsupported Responses role: system: Naslov je običajno pravilen. Preklopite na drug celoten ID s seznama modelov.

Uradne reference

Za namestitev glejte Namestitev goose. Za ponudnike po meri glejte ponudniki goose. Za ID-je modelov, uporabljene v primerih, glejte stran z modeli xAI in GPT-6 Luna.

Zamenjajte vsako mesto z vrednostmi iz vaše lastne konfiguracije OmniProxy. Nikoli ne objavite resničnega ključa.

Shranjen rezultat ali HTTP 200 sam po sebi ne dokazuje popolne združljivosti agenta. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · goose ↗