Inštalácia goose a konfigurácia vlastného poskytovateľa

goose je univerzálny AI asistent, ktorý beží vo vašom počítači. Okrem kódovania dokáže zvládať výskum, písanie, automatizáciu a organizáciu údajov. Môžete ho používať prostredníctvom desktopovej aplikácie, terminálu alebo API, pričom desktopová a terminálová verzia zdieľajú rovnakú konfiguráciu modelu. Je vhodný na opakujúce sa úlohy kódovania a dokáže sa pripojiť aj k GitHubu, databázam a súborom.

Skôr než začnete

goose ponúka dve možnosti inštalácie: Desktop a CLI. Desktop je grafická verzia s oknom, zatiaľ čo CLI sa používa zadávaním príkazov v termináli. Obe zdieľajú rovnakú základnú konfiguráciu vrátane poskytovateľa a modelu. Poskytovateľ je konfigurácia pripojenia, ktorá hovorí goose, ktorú modelovú službu má použiť.

Chcete okno

goose Desktop

• Stiahnite zip na macOS
• Alebo použite brew cask
• Použite inštalačný balík na Linuxe

Iba terminál

goose CLI

• download_cli.sh
• Alebo Homebrew CLI
• Potom spustite goose session

Windows

Najprv vyberte prostredie

• Git Bash alebo MSYS2
• Môžete použiť aj PowerShell
• Ak príkaz nie je nájdený, pridajte ho do PATH

Pred spustením si pripravte ID modelu z aktuálneho zoznamu modelov. ID modelu je názov, ktorý modelová služba používa na identifikáciu konkrétneho modelu, a pri jeho používaní musíte skopírovať úplné ID.

Prvá inštalácia a spustenie

Ak chcete grafické okno

Existujú dva zdokumentované spôsoby inštalácie pre macOS:

• Stiahnite si ho zo stránky inštalácie. Stránka poskytuje verzie pre macOS Silicon a macOS Intel. Po stiahnutí extrahujte súbor zip a spustite aplikáciu vo vnútri.
• Alternatívne použite Homebrew:

brew install --cask block-goose

Toto stiahne rovnakú aplikáciu a dokáže spracovať aj aktualizácie.

Ak používate Apple Mac M3 a po otvorení aplikácie sa nezobrazí žiadne okno, skontrolujte, či ~/.config je čitateľný a zapisovateľný. goose používa tento adresár na zápis protokolov.

Pre desktopovú verziu Linuxu si ju stiahnite zo stránky inštalácie. Dostupné balíky sú DEB pre Ubuntu/Debian, RPM pre RHEL/Fedora a Flatpak. Na Debiane alebo Ubuntu stiahnite súbor DEB, otvorte adresár, kde bol uložený, spustite sudo dpkg -i (filename).deb, a potom otvorte goose z ponuky aplikácií. Nahraďte (filename) skutočným názvom súboru.

Pre desktopovú verziu Windows si ju stiahnite zo stránky inštalácie, extrahujte súbor zip a spustite aplikáciu vo vnútri.

Ak chcete iba terminálovú verziu

Na macOS a Linuxe spustite:

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

Ak chcete počas inštalácie preskočiť interaktívnu konfiguráciu, pridajte CONFIGURE=false pred bash:

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

Na macOS môžete tiež spustiť:

brew install block-goose-cli

Ak chcete aktualizovať nainštalované CLI, spustite:

goose update

Vo Windows je vyžadované jedno z nasledujúcich troch prostredí: Git Bash, ktorý je súčasťou Git for Windows a je označený ako odporúčaný; MSYS2; alebo PowerShell, ktorý je súčasťou Windows 10/11. V Git Bash a MSYS2 použite rovnaký download_cli.sh príkaz zobrazený vyššie. V PowerShell najprv stiahnite skript a potom ho spustite:

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

Ak vám povedia, že goose nie je v PATH, postupujte podľa stránky inštalácie a pridajte ~/.local/bin alebo %USERPROFILE%\.local\bin do aktuálnej konfigurácie shellu, potom znova otvorte terminál. PATH je súbor adresárov, v ktorých terminál vyhľadáva programy. Ak inštalačný adresár nie je zahrnutý, možno nebudete môcť spustiť nainštalovaný program priamym zadaním jeho názvu.

K 9. 10. 2026 bola verzia CLI 1.54.0. Inštalačný skript štandardne umiestni program do ~/.local/bin. Tento adresár môžete zmeniť pomocou GOOSE_BIN_DIR premennej prostredia. Ak ho zmeníte, skript automaticky neaktualizuje konfiguráciu shellu a terminál nahlási, že adresár nie je v PATH. Pridajte tento adresár do PATH alebo spustite goose pomocou jeho úplnej cesty.

Pri prvom použití goose vás požiada o konfiguráciu poskytovateľa. Môžete preskočiť vstavaných poskytovateľov a pridať vlastného poskytovateľa, ako je popísané v nasledujúcej časti. V termináli prejdite do adresára, kde chcete pracovať, a spustite:

goose session

Získanie hodnôt pripojenia z OmniProxy

Pripravte si adresu, kľúč a názov modelu z vašej vlastnej inštancie OmniProxy. Príklad vlastného poskytovateľa používa base_url končiaci na /v1/chat/completions, takže táto príručka nasleduje rovnaký formát:

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

Skopírujte úplný názov modelu z aktuálneho zoznamu OmniProxy vrátane lomiek. K 9. 10. 2026 boli dve referenčné ID v dokumentácii poskytovateľa grok-4.7 pre Grok a gpt-6-luna z dokumentácie OpenAI. gpt-6-luna podporuje Chat Completions; volanie funkcií v Chat Completions je podporované iba vtedy, keď reasoning_effort je nastavené na none. Nekopírujte názov, ktorý sa v zozname nenachádza.

Zadanie konfigurácie nástroja

Vlastný poskytovateľ môže používať formát kompatibilný s OpenAI, Anthropic alebo Ollama. Kompatibilný formát znamená, že nástroj odosiela požiadavky podľa spoločnej špecifikácie API. Pri pripájaní k OmniProxy vyberte OpenAI Compatible.

Desktop

1. Kliknite na tlačidlo v ľavom hornom rohu a otvorte bočný panel.
2. Kliknite na Settings.
3. Kliknite na Models.
4. Kliknite na Configure providers.
5. Kliknite na Add Custom Provider v spodnej časti okna.
6. Pre typ poskytovateľa vyberte OpenAI Compatible. Zobrazovaný názov môžete nastaviť na OmniProxy. Do API URL zadajte adresu z predchádzajúcej časti. Ak je vyžadovaný kľúč, vyberte možnosť vyžadujúcu API Key a zadajte svoj kľúč OmniProxy. V časti Available Models zadajte názvy modelov, pričom viaceré názvy oddeľte čiarkami.
7. Kliknite na Create Provider.

Desktopová verzia v súčasnosti v tomto okne nedokáže definovať vlastné hlavičky požiadaviek. Ak potrebujete hlavičky požiadaviek, po vytvorení poskytovateľa upravte konfiguračný súbor.

Terminál

Spustite:

goose configure

Vyberte Custom Providers, potom vyberte Add A Custom Provider. Pre typ API vyberte OpenAI Compatible, potom postupujte podľa pokynov a zadajte názov, API URL, či je vyžadovaný kľúč, názvy modelov a či sú podporované streamované odpovede.

Pri manuálnej konfigurácii vo Windows, ak kľúčenka nahlási chybu, inštalačné pokyny hovoria, aby ste odmietli uloženie kľúča v kľúčenke a namiesto toho použili premennú prostredia. Potom spustite goose configure znova. Kľúčenka je malý bezpečný úložný systém používaný operačným systémom na ukladanie tajomstiev.

Konfiguračný súbor

Zdokumentované adresáre sú:

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

Súbor môžete založiť na poskytnutom príklade. Nahraďte názov, adresu a modely svojimi vlastnými hodnotami. Kľúč uložte do premennej prostredia špecifikovanej pomocou api_key_env; nezapisujte skutočný kľúč do súboru:

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

Ponechajte číselnú hodnotu pre context_limit, ako je znázornené v príklade. Skutočný limit kontextu závisí od modelu a OmniProxy; nepovažujte príkladové číslo za oficiálny limit modelu. Pred použitím spustite:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Po vstupe do pracovného adresára spustite:

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

Nahraďte hodnotu --model úplným ID zo zoznamu. goose session nemá podpríkaz start . Môžete tiež nastaviť --provider a --model prostredníctvom GOOSE_PROVIDER a GOOSE_MODEL premenných prostredia. Aj keď brána neoveruje kľúče, OMNIPROXY_API_KEY musí mať stále hodnotu. Môže to byť zástupný reťazec používaný iba vo vašom lokálnom počítači. Táto konfigurácia úspešne prečítala súbor pri testovaní 9. 10. 2026.

Okno

Nastavenia

• Nastavenia na bočnom paneli
• Stránka modelov
• Pridať vlastného poskytovateľa

Terminál

goose configure

• Vyberte vlastných poskytovateľov
• Potom vyberte pridať
• Ako typ vyberte OpenAI Compatible

Súbor

custom_providers

• Na macOS a Linuxe je pod ~/.config
• Vo Windows je pod APPDATA
• Nastavte base_url podľa oficiálneho príkladu

Overenie skutočnou úlohou

Otvorte adresár obsahujúci bežný súbor a spustite goose session ako je znázornené v predchádzajúcej časti. Požiadajte ho, aby prečítal prvý riadok súboru, ktorý špecifikujete. Mal by vrátiť obsah súboru namiesto toho, aby len povedal, že konfigurácia bola uložená.

Na čítanie súborov alebo vykonávanie príkazov relácia potrebuje rozšírenie Developer. Rozšírenie Developer je modul nástroja, ktorý umožňuje goose pracovať s lokálnymi súbormi a príkazmi. Zvyčajne je zahrnuté vo východiskovej konfigurácii. Ak goose povie, že nemá žiadne nástroje na súbory, pridajte k príkazu nasledujúce:

--with-builtin developer

Nepridávajte tiež --no-profile, pretože táto možnosť zakáže predvolené rozšírenia.

Pri testovaní 9. 10. 2026 goose 1.54.0 úspešne prečítal prvý riadok špecifikovaného súboru. Prvá odpoveď môže trvať približne jednu minútu.

Potom skontrolujte protokoly požiadaviek OmniProxy, aby ste potvrdili zdroj a názov modelu.

Spustenie

Relácia sa otvorí

• goose session
• Poskytovateľ je ten, ktorý bol práve pridaný
• Názov modelu je v zozname

Úloha

Skutočne dokončil úlohu

• Napríklad vypíšte aktuálny adresár
• Skontrolujte jeho odpoveď
• Nespoliehajte sa len na úspešné uloženie

Protokoly

Viditeľné v bráne

• Použite adresu z príkladu v dokumentácii
• Nedávajte kľúč do repozitára
• ID modelu sa zhoduje so zoznamom

Bežné chyby

• Príkaz goose nemožno nájsť: Pridajte inštalačný adresár do PATH, ako je popísané na stránke inštalácie, potom znova otvorte terminál.
• V desktopovej verzii na M3 Mac sa nezobrazí žiadne okno: Skontrolujte povolenia na čítanie a zápis pre ~/.config.
• Kľúčenka zlyhá: Neukladajte kľúč v kľúčenke; namiesto toho použite premennú prostredia.
• Model nie je v zozname: V desktopovej verzii vyberte Use custom model a zadajte názov modelu manuálne. goose configure nemôže akceptovať vlastný názov modelu. Pre použitie v termináli prepnite na desktopovú verziu alebo upravte GOOSE_MODEL priamo v konfigurácii.
• Adresu nemožno dosiahnuť: Potvrďte, že API URL končí na /v1/chat/completions, ako v príklade, a že OmniProxy beží.
• Hovorí, že nemôže čítať súbory: Pridajte rozšírenie Developer a nepoužívajte --no-profile.
• Vráti unsupported Responses role: system: Adresa je zvyčajne správna. Prepnite na iné úplné ID zo zoznamu modelov.

Oficiálne referencie

Pre inštaláciu pozri Inštalácia goose. Pre vlastných poskytovateľov pozri poskytovatelia goose. Pre ID modelov použité v príkladoch pozri stránku modelov xAI a GPT-6 Luna.

Nahraďte každú zástupnú hodnotu hodnotami z vašej vlastnej konfigurácie OmniProxy. Nikdy nezverejňujte skutočný kľúč.

Uložený výsledok alebo HTTP 200 sám o sebe nepreukazuje plnú kompatibilitu Agentov. Skontrolujte zdroj a model v zázname volania OmniProxy.

Oficiálne zdroje · goose ↗