Instalacja goose i konfiguracja niestandardowego Provider

goose to uniwersalny asystent AI działający na Twoim komputerze. Oprócz pracy z kodem może również wyszukiwać informacje, pisać, automatyzować zadania i porządkować dane. Możesz korzystać z niego w aplikacji desktopowej, terminalu lub przez interfejs, a wersje desktopowa i terminalowa używają tej samej konfiguracji modeli. Nadaje się do wykonywania powtarzalnych zadań programistycznych, a także może łączyć się z GitHubem, bazami danych i plikami.

Przygotowanie przed instalacją

goose można zainstalować jako Desktop lub CLI. Desktop to wersja z interfejsem okienkowym, natomiast CLI obsługuje się poleceniami wpisywanymi w terminalu. Obie wersje współdzielą podstawową konfigurację, w tym Provider i modele. Provider można rozumieć jako ustawienie połączenia, które informuje goose, z jakiej usługi modelowej ma korzystać.

Chcesz okno

goose Desktop

• Na macOS pobierz zip
• Lub użyj brew cask
• W systemie Linux użyj pakietu instalacyjnego

Tylko terminal

goose CLI

• download_cli.sh
• Lub Homebrew CLI
• Następnie goose session

Windows

Najpierw wybierz środowisko

• Git Bash lub MSYS2
• Możesz też użyć PowerShell
• Jeśli polecenia nie znaleziono, dodaj je do PATH

Przed rozpoczęciem przygotuj identyfikator modelu z aktualnej listy modeli. Identyfikator modelu to nazwa używana przez usługę modelową do rozpoznawania konkretnego modelu. Podczas konfiguracji trzeba skopiować go w całości.

Instalacja i pierwsze uruchomienie

Jeśli chcesz używać interfejsu okienkowego

Dla systemu macOS dostępne są dwie metody instalacji:

• Pobierz aplikację ze strony instalacyjnej. Dostępne są tam wersje macOS Silicon i macOS Intel. Po pobraniu rozpakuj plik zip i uruchom znajdujący się w nim program.
• Możesz też użyć Homebrew:

brew install --cask block-goose

Pobierana jest ta sama aplikacja, a Homebrew może również obsługiwać jej aktualizacje.

Jeśli na komputerze Apple Mac M3 po otwarciu aplikacji nie pojawia się żadne okno, sprawdź, czy katalog ~/.config ma uprawnienia do odczytu i zapisu. goose używa tego katalogu do zapisywania dzienników.

Wersję desktopową dla systemu Linux pobierz ze strony instalacyjnej. Dostępne są pakiety DEB (Ubuntu/Debian), RPM (RHEL/Fedora) oraz Flatpak. W Debianie lub Ubuntu wykonaj następujące czynności: pobierz plik DEB, przejdź do katalogu, w którym został zapisany, wykonaj sudo dpkg -i (filename).deb, a następnie otwórz goose z menu aplikacji. Zastąp (filename) rzeczywistą nazwą pliku.

Wersję desktopową dla systemu Windows pobierz ze strony instalacyjnej, rozpakuj plik zip i uruchom znajdujący się w nim program.

Jeśli potrzebujesz tylko terminala

W systemach macOS i Linux wykonaj:

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

Jeśli podczas instalacji nie chcesz przechodzić przez interaktywną konfigurację, dodaj na początku CONFIGURE=false:

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

W systemie macOS możesz również wykonać:

brew install block-goose-cli

Aby zaktualizować zainstalowane CLI, użyj:

goose update

W systemie Windows wymagane jest jedno z trzech środowisk: Git Bash, dostarczany z Git for Windows i oznaczony jako zalecany, MSYS2 albo PowerShell wbudowany w Windows 10/11. W Git Bash i MSYS2 użyj tego samego polecenia download_cli.sh, które podano powyżej. W PowerShell najpierw pobierz skrypt, a następnie go uruchom:

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

Jeśli pojawi się informacja, że goose nie znajduje się w PATH, zgodnie z instrukcjami na stronie instalacyjnej dodaj ~/.local/bin albo %USERPROFILE%\.local\bin do konfiguracji bieżącej powłoki, a następnie ponownie uruchom terminal. PATH to zestaw katalogów, w których terminal szuka programów. Jeśli katalog nie został do niego dodany, bezpośrednie uruchomienie programu przez wpisanie jego nazwy może być niemożliwe, mimo że program jest już zainstalowany.

W dniu 2026-10-09 wersja CLI to 1.54.0. Skrypt instalacyjny domyślnie umieszcza program w ~/.local/bin. Katalog ten można zmienić za pomocą zmiennej środowiskowej GOOSE_BIN_DIR. Po zmianie skrypt nie zapisze automatycznie odpowiednich ustawień w konfiguracji powłoki, a terminal poinformuje, że katalog nie znajduje się w PATH. Dodaj ten katalog do PATH albo uruchamiaj program przy użyciu pełnej ścieżki.

Przy pierwszym użyciu goose poprosi o skonfigurowanie Provider. Możesz pominąć wbudowanych dostawców i dodać niestandardowego Provider zgodnie z następną sekcją. W terminalu przejdź do katalogu, w którym chcesz pracować, i uruchom:

goose session

Pobieranie parametrów połączenia z OmniProxy

Przygotuj adres, klucz i nazwę modelu z własnej instancji OmniProxy. Oficjalny przykład niestandardowego Provider ustawia base_url na ścieżkę /v1/chat/completions, dlatego tutaj używany jest ten sam format:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Skopiuj z aktualnej listy modeli OmniProxy; wiele pozycji rozdziel przecinkami

Skopiuj pełną nazwę modelu z aktualnej listy OmniProxy, zachowując również ukośniki. W dniu 2026-10-09 dwa porównawcze identyfikatory w dokumentacji dostawców to grok-4.7 dla Groka oraz gpt-6-luna z dokumentacji OpenAI. gpt-6-luna obsługuje Chat Completions. Wywoływanie funkcji w Chat Completions jest obsługiwane wyłącznie wtedy, gdy reasoning_effort ma wartość none. Nie kopiuj nazw, których nie ma na liście.

Wprowadzanie konfiguracji narzędzia

Niestandardowy Provider korzysta z formatu zgodnego z OpenAI, Anthropic albo Ollama. Format zgodny oznacza, że narzędzie wysyła żądania przy użyciu określonego wspólnego interfejsu. Podczas łączenia z OmniProxy wybierz OpenAI Compatible.

Wersja desktopowa

1. Kliknij przycisk w lewym górnym rogu, aby otworzyć pasek boczny.
2. Kliknij Settings.
3. Kliknij Models.
4. Kliknij Configure providers.
5. Kliknij Add Custom Provider u dołu okna.
6. Jako Provider Type wybierz OpenAI Compatible. W polu Display Name możesz wpisać OmniProxy. W polu API URL wpisz adres z poprzedniej sekcji. Jeśli wymagany jest klucz, zaznacz opcję wymagania API Key i wprowadź klucz OmniProxy. W polu Available Models wpisz nazwy modeli, rozdzielając wiele pozycji przecinkami.
7. Kliknij Create Provider.

Obecnie w tym oknie wersji desktopowej nie można definiować niestandardowych nagłówków żądań. Jeśli są potrzebne, po utworzeniu Provider zmodyfikuj plik konfiguracyjny.

Terminal

Uruchom:

goose configure

Wybierz Custom Providers, a następnie Add A Custom Provider. Jako API Type wybierz OpenAI Compatible, po czym zgodnie z instrukcjami podaj nazwę, API URL, informację o wymaganiu klucza, nazwę modelu oraz informację o obsłudze odpowiedzi strumieniowych.

Jeśli podczas ręcznej konfiguracji w systemie Windows pojawi się błąd magazynu kluczy, instrukcja instalacji zaleca, aby na pytanie o zapis w keyring odpowiedzieć odmownie i zamiast tego użyć zmiennej środowiskowej. Następnie ponownie uruchom goose configure. Magazyn kluczy to niewielka bezpieczna przestrzeń systemowa służąca do przechowywania kluczy.

Plik konfiguracyjny

Podane katalogi to:

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

Plik możesz utworzyć na podstawie poniższego przykładu. Zastąp nazwę, adres i modele własnymi wartościami. Klucz umieść w zmiennej środowiskowej wskazanej przez api_key_env; nie zapisuj prawdziwego klucza bezpośrednio w pliku:

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

W polu context_limit pozostaw liczbę zgodnie z przykładem. Rzeczywisty kontekst zależy od modelu i OmniProxy, więc nie traktuj tej przykładowej wartości jako oficjalnego limitu danego modelu. Przed użyciem wykonaj:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Po przejściu do katalogu roboczego uruchom:

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

Zastąp wartość --model pełnym identyfikatorem z listy. goose session nie ma podpolecenia start. Opcje --provider i --model można również ustawić za pomocą zmiennych środowiskowych GOOSE_PROVIDER i GOOSE_MODEL. Nawet jeśli brama nie weryfikuje klucza, OMNIPROXY_API_KEY nadal musi mieć wartość. Może to być ciąg znaków zastępczych używany wyłącznie lokalnie. W dniu 2026-10-09 taka konfiguracja umożliwiła odczytanie pliku.

Okno

Settings

• Settings na pasku bocznym
• Strona Models
• Add Custom Provider

Terminal

goose configure

• Wybierz Custom Providers
• Następnie wybierz dodawanie
• Jako typ wybierz OpenAI Compatible

Plik

custom_providers

• Na macOS i Linux w ~/.config
• W Windows w APPDATA
• base_url ustaw zgodnie z oficjalnym przykładem

Weryfikacja na rzeczywistym zadaniu

Przejdź do katalogu zawierającego zwykły plik i uruchom polecenie goose session z poprzedniej sekcji. Poproś goose o odczytanie pierwszego wiersza wskazanego pliku. Odpowiedź powinna zawierać treść pliku, a nie tylko informację o zapisaniu konfiguracji.

Aby odczytywać pliki lub wykonywać polecenia, sesja wymaga rozszerzenia Developer. Rozszerzenie Developer można rozumieć jako moduł narzędziowy umożliwiający goose pracę z lokalnymi plikami i poleceniami. Zwykle jest ono dołączone do konfiguracji domyślnej. Jeśli goose odpowie, że nie ma narzędzi do obsługi plików, dodaj do polecenia:

--with-builtin developer

Nie dodawaj jednocześnie --no-profile, ponieważ ten parametr wyłącza domyślne rozszerzenia.

W dniu 2026-10-09 goose 1.54.0 odczytał pierwszy wiersz wskazanego pliku. Pierwsza odpowiedź może zająć około minuty.

Następnie sprawdź źródło i nazwę modelu w historii wywołań OmniProxy.

Uruchomienie

Możesz wejść do sesji

• goose session
• Provider to właśnie dodany dostawca
• Nazwa modelu jest na liście

Zadanie

Naprawdę coś zrobił

• Na przykład wyświetl bieżący katalog
• Sprawdź jego odpowiedź
• Nie patrz tylko na komunikat o pomyślnym zapisie

Rejestr

Brama go widzi

• Kieruj się przykładem w dokumentacji
• Nie zapisuj klucza w repozytorium
• Identyfikator modelu jest zgodny z listą

Typowe błędy

• Nie można znaleźć polecenia goose: zgodnie z instrukcjami na stronie instalacyjnej dodaj katalog instalacyjny do PATH, a następnie ponownie uruchom terminal.
• Brak okna wersji desktopowej na komputerze M3: sprawdź uprawnienia do odczytu i zapisu katalogu ~/.config.
• Błąd magazynu kluczy: nie zapisuj klucza w keyring; zamiast tego użyj zmiennej środowiskowej.
• Modelu nie ma na liście: w wersji desktopowej możesz wybrać Use custom model i ręcznie wpisać nazwę modelu. goose configure nie pozwala wprowadzić niestandardowej nazwy modelu. W terminalu użyj wersji desktopowej albo bezpośrednio zmień GOOSE_MODEL w konfiguracji.
• Nie można połączyć się z adresem: upewnij się, że API URL, tak jak w przykładzie, kończy się ścieżką /v1/chat/completions oraz że OmniProxy jest uruchomiony.
• goose informuje, że nie może odczytać pliku: dodaj rozszerzenie Developer i nie używaj --no-profile.
• Zwracany jest błąd unsupported Responses role: system: adres jest zazwyczaj prawidłowy. Wybierz inny pełny identyfikator z listy modeli.

Oficjalne materiały

Instrukcje instalacji znajdziesz na stronie Install goose. Informacje o niestandardowym Provider są dostępne na stronie goose providers. Przykładowe identyfikatory modeli znajdują się na stronach modele xAI i GPT-6 Luna.

Zastąp każdy placeholder wartościami z własnej konfiguracji OmniProxy. Nigdy nie publikuj prawdziwego klucza.

Zapisany wynik lub HTTP 200 samo w sobie nie dowodzi pełnej kompatybilności Agenta. Sprawdź źródło i model w rejestrze połączeń OmniProxy.

Źródła oficjalne · goose ↗