Namestitev orodja goose in konfiguracija ponudnika po meri

goose je vsestranski pomočnik z umetno inteligenco, 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 s storitvijo GitHub, bazami podatkov in datotekami.

Preden začnete

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

Želite okno

goose Desktop

• Prenesite zip na macOS
• Ali uporabite brew cask
• Uporabite namestitveni paket na 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, pri uporabi pa morate kopirati celoten ID.

Prva namestitev in zagon

Če želite grafično okno

Za macOS sta dokumentirani dve metodi namestitve:

• Prenesite ga s strani za namestitev. Stran ponuja različici za 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 tudi upravlja 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 to mapo za zapisovanje dnevnikov.

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

Za namizno različico Windows prenesite datoteko zip s strani za namestitev, jo izvlecite 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, pred bash dodajte CONFIGURE=false:

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 for Windows in označen kot priporočen; MSYS2; ali PowerShell, vključen v Windows 10/11. V Git Bash in MSYS2 uporabite isti ukaz download_cli.sh, kot je 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 prejmete obvestilo, 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 map, v katerih terminal išče programe. Če namestitvena mapa ni vključena, morda ne boste mogli zagnati nameščenega programa z vnosom njegovega imena.

Na dan 9. 10. 2026 je bila različica CLI 1.54.0. Namestitveni skript privzeto postavi program v ~/.local/bin. To mapo lahko spremenite z okoljsko spremenljivko GOOSE_BIN_DIR. Če jo spremenite, skript ne bo samodejno posodobil konfiguracije lupine in terminal bo poročal, da mapa ni v PATH. Dodajte to mapo v PATH ali zaženite goose s celotno potjo.

Ob prvi uporabi orodja 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 v mapo, 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, če je reasoning_effort nastavljen 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.

Namizje

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 in jih 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, po ustvarjanju ponudnika uredite konfiguracijsko datoteko.

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, naslova API URL, 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, da zavrnete shranjevanje ključa v obesek in namesto tega uporabite okoljsko spremenljivko. Nato znova zaženite goose configure. Obesek za ključe je majhen varen sistem za shranjevanje, ki ga operacijski sistem uporablja za shranjevanje skrivnosti.

Konfiguracijska datoteka

Dokumentirane mape so:

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

Datoteko lahko ustvarite na podlagi priloženega primera. Zamenjajte ime, naslov in modele s svojimi vrednostmi. Ključ shranite v okoljsko spremenljivko, določeno z api_key_env; pravega ključa ne zapisujte 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
}

Za context_limit ohranite številčno vrednost, kot je prikazano v primeru. Dejanska omejitev konteksta je odvisna od modela in OmniProxy; primera številke ne obravnavajte kot uradno omejitev modela. Pred uporabo zaženite:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Po vstopu v delovno mapo zaženite:

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

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

Okno

Settings

• Settings v stranski vrstici
• Stran Models
• Add Custom Provider

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 z dejansko nalogo

Odprite mapo, 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 le sporoči, da je bila konfiguracija shranjena.

Za branje datotek ali izvajanje ukazov seja potrebuje razširitev Developer. Razširitev Developer je modul orodij, ki omogoča, da goose deluje z lokalnimi datotekami in ukazi. Običajno je vključena v privzeto konfiguracijo. Če goose sporoči, 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

Seja se odpre

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

Naloga

Dejansko je opravil nalogo

• Na primer, izpišite trenutno mapo
• Preglejte njegov odziv
• Ne zanašajte se le na uspešno shranjevanje

Dnevniki

Vidni v prehodu

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

Pogoste napake

• Ukaza goose ni mogoče najti: Dodajte namestitveno mapo v PATH, kot je opisano na strani za namestitev, nato ponovno odprite terminal.
• V namizni različici na M3 Mac se ne prikaže okno: Preverite dovoljenja za branje in pisanje za ~/.config.
• Obesek za ključe ne deluje: Ključa ne shranjujte v obesek; 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 neposredno uredite GOOSE_MODEL v konfiguraciji.
• Naslov ni dosegljiv: Potrdite, da se API URL 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 Install goose. Za ponudnike po meri glejte goose providers. Za ID-je modelov, uporabljene v primerih, glejte stran modelov 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 Agentov. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · goose ↗