Instalace goose a konfigurace vlastního poskytovatele

goose je univerzální AI asistent, který běží ve vašem počítači. Kromě kódování zvládne výzkum, psaní, automatizaci a organizaci dat. Můžete jej používat prostřednictvím desktopové aplikace, terminálu nebo API, přičemž desktopová a terminálová verze sdílejí stejnou konfiguraci modelu. Je vhodný pro opakující se úkoly kódování a může se také připojit ke GitHubu, databázím a souborům.

Než začnete

goose nabízí dvě možnosti instalace: Desktop a CLI. Desktop je grafická verze s oknem, zatímco CLI se používá zadáváním příkazů v terminálu. Obě sdílejí stejnou základní konfiguraci, včetně poskytovatele a modelu. Poskytovatel je konfigurace připojení, která říká goose, jakou modelovou službu použít.

Chcete okno

goose Desktop

Stáhněte zip na macOS
Nebo použijte brew cask
Použijte instalační balíček na Linuxu

Pouze terminál

goose CLI

download_cli.sh
Nebo Homebrew CLI
Poté spusťte goose session

Windows

Nejprve zvolte prostředí

Git Bash nebo MSYS2
Můžete také použít PowerShell
Pokud příkaz nebyl nalezen, přidejte jej do PATH

Na macOS jej můžete nainstalovat stažením aplikace nebo pomocí Homebrew. Na Linuxu použijte balíček vaší distribuce pro desktopovou verzi. Ve Windows nejprve zkontrolujte podporovaná terminálová prostředí.

Před spuštěním si připravte ID modelu z aktuálního seznamu modelů. ID modelu je název, který modelová služba používá k identifikaci konkrétního modelu, a při jeho použití musíte zkopírovat úplné ID.

Instalace a první spuštění

Pokud chcete grafické okno

Pro macOS existují dvě zdokumentované metody instalace:

Stáhněte si jej ze stránky instalace. Stránka poskytuje verze pro macOS Silicon a macOS Intel. Po stažení extrahujte soubor zip a spusťte aplikaci uvnitř.
Alternativně použijte Homebrew:

brew install --cask block-goose

Tím se stáhne stejná aplikace a lze také spravovat aktualizace.

Pokud používáte Apple Mac M3 a po otevření aplikace se neobjeví žádné okno, zkontrolujte, zda ~/.config je čitelný a zapisovatelný. goose používá tento adresář k zápisu protokolů.

Pro desktopovou verzi pro Linux ji stáhněte ze stránky instalace. Dostupné balíčky jsou DEB pro Ubuntu/Debian, RPM pro RHEL/Fedora a Flatpak. Na Debianu nebo Ubuntu stáhněte soubor DEB, otevřete adresář, kam byl uložen, spusťte sudo dpkg -i (filename).deb, a poté otevřete goose z nabídky aplikací. Nahraďte (filename) skutečným názvem souboru.

Pro desktopovou verzi pro Windows ji stáhněte ze stránky instalace, extrahujte soubor zip a spusťte aplikaci uvnitř.

Pokud chcete pouze terminálovou verzi

Na macOS a Linuxu spusťte:

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

Chcete-li během instalace přeskočit interaktivní konfiguraci, přidejte CONFIGURE=false před bash:

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

Na macOS můžete také spustit:

brew install block-goose-cli

Chcete-li aktualizovat nainstalované CLI, spusťte:

goose update

Ve Windows je vyžadováno jedno z následujících tří prostředí: Git Bash, který je součástí Git for Windows a je označen jako doporučený; MSYS2; nebo PowerShell, který je součástí Windows 10/11. V Git Bash a MSYS2 použijte stejný download_cli.sh příkaz uvedený výše. V PowerShellu nejprve stáhněte skript a poté jej spusťte:

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

Pokud vám bylo řečeno, že goose není v PATH, postupujte podle stránky instalace a přidejte ~/.local/bin nebo %USERPROFILE%\.local\bin do aktuální konfigurace shellu, poté znovu otevřete terminál. PATH je sada adresářů, ve kterých terminál vyhledává programy. Pokud instalační adresář není zahrnut, možná nebudete moci spustit nainstalovaný program zadáním jeho názvu přímo.

K 9. 10. 2026 byla verze CLI 1.54.0. Ve výchozím nastavení instalační skript umístí program do ~/.local/bin. Tento adresář můžete změnit pomocí GOOSE_BIN_DIR proměnné prostředí. Pokud jej změníte, skript automaticky neaktualizuje konfiguraci shellu a terminál ohlásí, že adresář není v PATH. Přidejte tento adresář do PATH nebo spusťte goose pomocí jeho úplné cesty.

Při prvním použití goose vás požádá o konfiguraci poskytovatele. Můžete přeskočit vestavěné poskytovatele a přidat vlastního poskytovatele, jak je popsáno v další části. V terminálu přejděte do adresáře, kde chcete pracovat, a spusťte:

goose session

Získání hodnot připojení z OmniProxy

Připravte si adresu, klíč a název modelu z vlastní instance OmniProxy. Příklad vlastního poskytovatele používá base_url končící na /v1/chat/completions, takže tato příručka následuje stejný 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

Zkopírujte úplný název modelu z aktuálního seznamu OmniProxy, včetně všech lomítek. K 9. 10. 2026 byla dvě referenční ID v dokumentaci poskytovatele grok-4.7 pro Grok a gpt-6-luna z dokumentace OpenAI. gpt-6-luna podporuje Chat Completions; volání funkcí v Chat Completions je podporováno pouze tehdy, když reasoning_effort je nastaveno na none. Nekopírujte název, který se v seznamu neobjevuje.

Zadání konfigurace nástroje

Vlastní poskytovatel může používat formát kompatibilní s OpenAI, Anthropic nebo Ollama. Kompatibilní formát znamená, že nástroj odesílá požadavky podle běžné specifikace API. Při připojování k OmniProxy vyberte OpenAI Compatible.

Desktop

Kliknutím na tlačítko v levém horním rohu otevřete postranní panel.
Klikněte na Settings.
Klikněte na Models.
Klikněte na Configure providers.
Klikněte na Add Custom Provider v dolní části okna.
Pro typ poskytovatele vyberte OpenAI Compatible. Zobrazovaný název můžete nastavit na OmniProxy. Do API URL zadejte adresu z předchozí části. Pokud je vyžadován klíč, vyberte možnost vyžadující API Key a zadejte svůj klíč OmniProxy. V Available Models zadejte názvy modelů, přičemž více názvů oddělte čárkami.
Klikněte na Create Provider.

Desktopová verze v současné době nemůže v tomto okně definovat vlastní hlavičky požadavků. Pokud potřebujete hlavičky požadavků, upravte konfigurační soubor po vytvoření poskytovatele.

Terminál

Spusťte:

goose configure

Vyberte Custom Providers, poté vyberte Add A Custom Provider. Pro typ API vyberte OpenAI Compatible, poté postupujte podle pokynů pro zadání názvu, API URL, zda je vyžadován klíč, názvů modelů a zda je podporováno streamování odpovědí.

Při ruční konfiguraci ve Windows, pokud klíčenka nahlásí chybu, instalační pokyny říkají, abyste odmítli uložení klíče v klíčence a místo toho použili proměnnou prostředí. Poté spusťte goose configure znovu. Klíčenka je malý zabezpečený úložný systém používaný operačním systémem k ukládání tajných údajů.

Konfigurační soubor

Zdokumentované adresáře jsou:

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

Soubor můžete založit na poskytnutém příkladu. Nahraďte název, adresu a modely vlastními hodnotami. Klíč uložte do proměnné prostředí specifikované pomocí api_key_env; nezapisujte skutečný klíč do souboru:

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

Ponechte číselnou hodnotu pro context_limit, jak je znázorněno v příkladu. Skutečný limit kontextu závisí na modelu a OmniProxy; nepovažujte příkladové číslo za oficiální limit modelu. Před použitím spusťte:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Po vstupu do pracovního adresáře spusťte:

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

Nahraďte hodnotu --model úplným ID ze seznamu. goose session nemá podpříkaz start . Můžete také nastavit --provider a --model prostřednictvím GOOSE_PROVIDER a GOOSE_MODEL proměnných prostředí. I když brána klíče neověřuje, OMNIPROXY_API_KEY musí stále mít hodnotu. Může to být zástupný řetězec používaný pouze ve vašem místním počítači. Tato konfigurace úspěšně přečetla soubor při testování 9. 10. 2026.

Okno

Nastavení

Nastavení v postranním panelu
Stránka modelů
Přidat vlastního poskytovatele

Terminál

goose configure

Vyberte vlastní poskytovatele
Poté vyberte přidat
Jako typ zvolte OpenAI Compatible

Soubor

custom_providers

Na macOS a Linuxu je pod ~/.config
Ve Windows je pod APPDATA
Nastavte base_url podle oficiálního příkladu

Všechny tři metody vytvářejí stejný typ konfigurace. Jako typ poskytovatele vyberte OpenAI Compatible.

Ověření pomocí skutečného úkolu

Otevřete adresář obsahující běžný soubor a spusťte goose session jak je znázorněno v předchozí části. Požádejte jej o přečtení prvního řádku souboru, který určíte. Měl by vrátit obsah souboru, místo aby pouze řekl, že konfigurace byla uložena.

Pro čtení souborů nebo provádění příkazů relace potřebuje rozšíření Developer. Rozšíření Developer je modul nástrojů, který umožňuje goose pracovat s místními soubory a příkazy. Je obecně zahrnuto ve výchozí konfiguraci. Pokud goose říká, že nemá žádné nástroje pro soubory, přidejte k příkazu následující:

--with-builtin developer

Nepřidávejte také --no-profile, protože tato možnost zakazuje výchozí rozšíření.

Při testování 9. 10. 2026 goose 1.54.0 úspěšně přečetl první řádek zadaného souboru. První odpověď může trvat přibližně jednu minutu.

Poté zkontrolujte protokoly požadavků OmniProxy pro potvrzení zdroje a názvu modelu.

Spuštění

Relace se otevře

goose session
Poskytovatel je ten právě přidaný
Název modelu je v seznamu

Úkol

Skutečně úkol dokončil

Například vypsat aktuální adresář
Zkontrolujte jeho odpověď
Nespoléhejte pouze na úspěšné uložení

Protokoly

Viditelné v bráně

Použijte adresu z příkladu v dokumentaci
Nedávejte klíč do repozitáře
ID modelu souhlasí se seznamem

Po uložení poskytovatele jej potvrďte skutečnou relací.

Běžné chyby

Příkaz goose nelze nalézt: Přidejte instalační adresář do PATH, jak je popsáno na stránce instalace, poté znovu otevřete terminál.
V desktopové verzi na M3 Macu se neobjeví žádné okno: Zkontrolujte oprávnění ke čtení a zápisu pro ~/.config.
Klíčenka selže: Neukládejte klíč v klíčence; místo toho použijte proměnnou prostředí.
Model není v seznamu: V desktopové verzi vyberte Use custom model a zadejte název modelu ručně. goose configure nemůže přijmout vlastní název modelu. Pro použití v terminálu přepněte na desktopovou verzi nebo upravte GOOSE_MODEL přímo v konfiguraci.
Adresu nelze dosáhnout: Potvrďte, že API URL končí na /v1/chat/completions, jako v příkladu, a že OmniProxy běží.
Říká, že nemůže číst soubory: Přidejte rozšíření Developer a nepoužívejte --no-profile.
Vrací unsupported Responses role: system: Adresa je obvykle správná. Přepněte na jiné úplné ID ze seznamu modelů.

Oficiální reference

Pro instalaci viz Instalace goose. Pro vlastní poskytovatele viz poskytovatelé goose. Pro ID modelů použitá v příkladech viz stránka modelů xAI a GPT-6 Luna.

Nahraďte všechna záložní místa hodnotami z vlastní konfigurace OmniProxy. Nikdy nezveřejňujte skutečný klíč.

Uložený výsledek nebo HTTP 200 samo o sobě nedokazuje plnou kompatibilitu agenta. Zkontrolujte zdroj a model v záznamu požadavku OmniProxy.

Oficiální zdroje · goose ↗