Instalacija alata goose i konfiguracija prilagođenog pružatelja usluga

goose je AI asistent opće namjene koji se pokreće na vašem računalu. Osim kodiranja, može se nositi s istraživanjem, pisanjem, automatizacijom i organizacijom podataka. Možete ga koristiti putem desktop aplikacije, terminala ili API-ja, a desktop i terminalska verzija dijele istu konfiguraciju modela. Pogodan je za ponavljajuće zadatke kodiranja, a može se povezati i s GitHub-om, bazama podataka i datotekama.

Prije početka

goose nudi dvije opcije instalacije: Desktop i CLI. Desktop je grafička verzija s prozorom, dok se CLI koristi unosom naredbi u terminalu. Obje dijele istu osnovnu konfiguraciju, uključujući pružatelja usluga (Provider) i model. Pružatelj usluga je konfiguracija povezivanja koja govori alatu goose koji model usluge koristiti.

Želite prozor

goose Desktop

• Preuzmite zip na macOS-u
• Ili koristite brew cask
• Koristite instalacijski paket na Linuxu

Samo terminal

goose CLI

• download_cli.sh
• Ili Homebrew CLI
• Zatim pokrenite goose session

Windows

Prvo odaberite okruženje

• Git Bash ili MSYS2
• Možete koristiti i PowerShell
• Ako naredba nije pronađena, dodajte je u PATH

Prije početka, pripremite ID modela s trenutnog popisa modela. ID modela je naziv koji usluga modela koristi za identifikaciju određenog modela, a prilikom korištenja morate kopirati cijeli ID.

Instalacija i prvo pokretanje

Ako želite grafički prozor

Postoje dvije dokumentirane metode instalacije za macOS:

• Preuzmite ga sa stranice za instalaciju. Stranica nudi verzije za macOS Silicon i macOS Intel. Nakon preuzimanja, izdvojite zip datoteku i pokrenite aplikaciju unutra.
• Alternativno, koristite Homebrew:

brew install --cask block-goose

Ovo preuzima istu aplikaciju i također može upravljati ažuriranjima.

Ako koristite Apple Mac M3 i prozor se ne pojavljuje nakon otvaranja aplikacije, provjerite je li ~/.config čitljiv i zapisiv. goose koristi ovaj direktorij za pisanje zapisnika (logs).

Za Linux desktop verziju, preuzmite je sa stranice za instalaciju. Dostupni paketi su DEB za Ubuntu/Debian, RPM za RHEL/Fedora i Flatpak. Na Debianu ili Ubuntuu preuzmite DEB datoteku, otvorite direktorij u kojem je spremljena, pokrenite sudo dpkg -i (filename).deb, a zatim otvorite goose iz izbornika aplikacija. Zamijenite (filename) stvarnim nazivom datoteke.

Za Windows desktop verziju, preuzmite je sa stranice za instalaciju, izdvojite zip datoteku i pokrenite aplikaciju unutra.

Ako želite samo terminalsku verziju

Na macOS-u i Linux-u pokrenite:

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

Za preskakanje interaktivne konfiguracije tijekom instalacije, dodajte CONFIGURE=false prije bash:

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

Na macOS-u također možete pokrenuti:

brew install block-goose-cli

Za ažuriranje instaliranog CLI-a, pokrenite:

goose update

Na Windowsima je potrebno jedno od sljedeća tri okruženja: Git Bash, koji je uključen uz Git for Windows i označen kao preporučen; MSYS2; ili PowerShell uključen uz Windows 10/11. U Git Bash-u i MSYS2-u koristite istu download_cli.sh naredbu prikazanu iznad. U PowerShell-u prvo preuzmite skriptu, a zatim je pokrenite:

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

Ako vam se kaže da goose nije u PATH-u, slijedite stranicu za instalaciju i dodajte ~/.local/bin ili %USERPROFILE%\.local\bin u trenutnu konfiguraciju ljuske (shell), a zatim ponovno otvorite terminal. PATH je skup direktorija koje terminal pretražuje za programe. Ako instalacijski direktorij nije uključen, možda nećete moći pokrenuti instalirani program izravnim unosom njegovog naziva.

Na datum 2026-10-09, CLI verzija bila je 1.54.0. Prema zadanim postavkama, instalacijska skripta postavlja program u ~/.local/bin. Ovaj direktorij možete promijeniti pomoću GOOSE_BIN_DIR varijable okruženja. Ako ga promijenite, skripta neće automatski ažurirati konfiguraciju ljuske, a terminal će prijaviti da direktorij nije u PATH-u. Dodajte taj direktorij u PATH ili pokrenite goose koristeći njegov puni put.

Prvi put kada koristite goose, tražit će od vas da konfigurirate pružatelja usluga (Provider). Možete preskočiti ugrađene pružatelje i dodati prilagođenog pružatelja kako je opisano u sljedećem odjeljku. U terminalu idite do direktorija u kojem želite raditi i pokrenite:

goose session

Dohvaćanje vrijednosti povezivanja iz OmniProxy-a

Pripremite adresu, ključ i naziv modela iz vlastite instance OmniProxy-a. Primjer prilagođenog pružatelja usluga koristi base_url koji završava s /v1/chat/completions, pa ovaj vodič slijedi isti 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

Kopirajte cijeli naziv modela s trenutnog popisa u OmniProxy-u, uključujući sve kose crte. Na datum 2026-10-09, dva referentna ID-a u dokumentaciji pružatelja usluga bila su grok-4.7 za Grok i gpt-6-luna iz OpenAI dokumentacije. gpt-6-luna podržava Chat Completions; pozivanje funkcija (function calling) u Chat Completions podržano je samo kada je reasoning_effort postavljeno na none. Nemojte kopirati naziv koji se ne pojavljuje na popisu.

Unos konfiguracije alata

Prilagođeni pružatelj usluga može koristiti format kompatibilan s OpenAI, Anthropic ili Ollama. Kompatibilan format znači da alat šalje zahtjeve prema zajedničkoj API specifikaciji. Prilikom povezivanja na OmniProxy, odaberite OpenAI Compatible.

Desktop

1. Kliknite gumb u gornjem lijevom kutu za otvaranje bočne trake.
2. Kliknite Settings.
3. Kliknite Models.
4. Kliknite Configure providers.
5. Kliknite Add Custom Provider na dnu prozora.
6. Za Provider Type odaberite OpenAI Compatible. Možete postaviti Display Name na OmniProxy. Unesite adresu iz prethodnog odjeljka u API URL. Ako je potreban ključ, odaberite opciju koja zahtijeva API Key i unesite svoj OmniProxy ključ. U Available Models unesite nazive modela, odvajajući više naziva zarezima.
7. Kliknite Create Provider.

Desktop verzija trenutno ne može definirati prilagođena zaglavlja zahtjeva (request headers) u ovom prozoru. Ako trebate zaglavlja zahtjeva, uredite konfiguracijsku datoteku nakon stvaranja pružatelja usluga.

Terminal

Pokrenite:

goose configure

Odaberite Custom Providers, zatim odaberite Add A Custom Provider. Za API Type odaberite OpenAI Compatible, a zatim slijedite upute za unos naziva, API URL-a, je li potreban ključ, naziva modela i je li podržan streaming odgovora.

Prilikom ručne konfiguracije na Windowsima, ako privjesak ključeva (keychain) prijavi pogrešku, upute za instalaciju kažu da odbijete spremanje ključa u privjesak i umjesto toga koristite varijablu okruženja. Zatim ponovno pokrenite goose configure . Privjesak ključeva je mali sigurni sustav za pohranu koji operacijski sustav koristi za pohranu tajni.

Konfiguracijska datoteka

Dokumentirani direktoriji su:

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

Datoteku možete temeljiti na priloženom primjeru. Zamijenite naziv, adresu i modele vlastitim vrijednostima. Pohranite ključ u varijablu okruženja navedenu pomoću api_key_env; nemojte pisati stvarni ključ u datoteku:

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

Zadržite brojčanu vrijednost za context_limit, kao što je prikazano u primjeru. Stvarno ograničenje konteksta ovisi o modelu i OmniProxy-u; nemojte tretirati primjer broja kao službeno ograničenje modela. Prije korištenja pokrenite:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Nakon ulaska u radni direktorij, pokrenite:

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

Zamijenite vrijednost --model punim ID-om s popisa. goose session nema podnaredbu start . Također možete postaviti --provider i --model putem GOOSE_PROVIDER i GOOSE_MODEL varijabli okruženja. Čak i ako pristupnik ne provjerava ključeve, OMNIPROXY_API_KEY i dalje mora imati vrijednost. To može biti zamjenski niz znakova koji se koristi samo na vašem lokalnom računalu. Ova konfiguracija uspješno je pročitala datoteku tijekom testiranja 2026-10-09.

Prozor

Settings

• Settings u bočnoj traci
• Stranica Models
• Add Custom Provider

Terminal

goose configure

• Odaberite Custom Providers
• Zatim odaberite add
• Odaberite OpenAI Compatible kao vrstu

Datoteka

custom_providers

• Na macOS-u i Linux-u nalazi se pod ~/.config
• Na Windowsima se nalazi pod APPDATA
• Postavite base_url prema službenom primjeru

Provjera sa stvarnim zadatkom

Otvorite direktorij koji sadrži običnu datoteku i pokrenite goose session kao što je prikazano u prethodnom odjeljku. Zamolite ga da pročita prvi redak datoteke koju navedete. Trebao bi vratiti sadržaj datoteke umjesto da samo kaže da je konfiguracija spremljena.

Za čitanje datoteka ili izvršavanje naredbi, sesiji je potreban Developer dodatak (extension). Developer dodatak je modul alata koji omogućuje alatu goose rad s lokalnim datotekama i naredbama. Općenito je uključen u zadanu konfiguraciju. Ako goose kaže da nema alate za datoteke, dodajte sljedeće naredbi:

--with-builtin developer

Nemojte dodavati i --no-profile, jer ta opcija onemogućuje zadane dodatke.

Tijekom testiranja 2026-10-09, goose 1.54.0 uspješno je pročitao prvi redak navedene datoteke. Prvi odgovor može potrajati oko jednu minutu.

Zatim provjerite zapisnike zahtjeva u OmniProxy-u kako biste potvrdili izvor i naziv modela.

Pokretanje

Sesija se otvara

• goose session
• Pružatelj usluga je onaj koji je upravo dodan
• Naziv modela je na popisu

Zadatak

Stvarno je dovršio zadatak

• Na primjer, izlistajte trenutni direktorij
• Pregledajte njegov odgovor
• Ne oslanjajte se samo na uspješno spremanje

Zapisnici

Vidljivo u pristupniku

• Koristite adresu iz primjera u dokumentaciji
• Ne stavljajte ključ u repozitorij
• ID modela se podudara s popisom

Uobičajene pogreške

• goose naredba se ne može pronaći: Dodajte instalacijski direktorij u PATH kako je opisano na stranici za instalaciju, a zatim ponovno otvorite terminal.
• Prozor se ne pojavljuje u desktop verziji na M3 Mac-u: Provjerite dozvole za čitanje i pisanje za ~/.config.
• Privjesak ključeva ne uspijeva: Nemojte spremati ključ u privjesak; umjesto toga koristite varijablu okruženja.
• Model nije na popisu: U desktop verziji odaberite Use custom model i ručno unesite naziv modela. goose configure ne može prihvatiti prilagođeni naziv modela. Za korištenje u terminalu, prebacite se na desktop verziju ili uredite GOOSE_MODEL izravno u konfiguraciji.
• Adresa nije dostupna: Potvrdite da API URL završava s /v1/chat/completions, kao u primjeru, i da je OmniProxy pokrenut.
• Kaže da ne može čitati datoteke: Dodajte Developer dodatak i nemojte koristiti --no-profile.
• Vraća unsupported Responses role: system: Adresa je obično točna. Prebacite se na drugi puni ID s popisa modela.

Službene reference

Za instalaciju pogledajte Instalacija alata goose. Za prilagođene pružatelje usluga pogledajte goose pružatelji usluga. Za ID-ove modela korištene u primjerima pogledajte stranicu xAI modela i GPT-6 Luna.

Zamijenite svaki predložak vrijednostima iz vlastite OmniProxy konfiguracije. Nikada ne objavite stvarni ključ.

Spremljeni rezultat ili HTTP 200 sami po sebi ne dokazuju punu kompatibilnost Agenta. Provjerite izvor i model u zapisu poziva OmniProxy.

Službeni izvori · goose ↗