A goose telepítése és egyéni szolgáltató konfigurálása

A goose egy általános célú AI-asszisztens, amely a számítógépén fut. A kódolás mellett kutatással, írással, automatizálással és adatszervezéssel is foglalkozhat. Használhatja asztali alkalmazáson, terminálon vagy API-n keresztül, és az asztali és terminálverziók ugyanazt a modellkonfigurációt osztják meg. Alkalmas ismétlődő kódolási feladatokra, és csatlakozhat a GitHubhoz, adatbázisokhoz és fájlokhoz is.

Mielőtt elkezdené

A goose két telepítési lehetőséget kínál: Desktop és CLI. A Desktop a grafikus verzió ablakkal, míg a CLI-t a terminálba beírt parancsokkal használhatja. Mindkettő ugyanazt az alapkonfigurációt osztja meg, beleértve a Szolgáltatót és a modellt. A Szolgáltató az a csatlakozási konfiguráció, amely megmondja a goose-nak, hogy melyik modellszolgáltatást használja.

Ablakot szeretne

goose Desktop

Töltse le a zip-et macOS-en
Vagy használja a brew cask-ot
Használja a telepítőcsomagot Linuxon

Csak terminál

goose CLI

download_cli.sh
Vagy a Homebrew CLI
Majd futtassa a goose session parancsot

Windows

Először válasszon környezetet

Git Bash vagy MSYS2
Használhat PowerShellt is
Ha a parancs nem található, adja hozzá a PATH-hoz

macOS-en telepítheti az alkalmazás letöltésével vagy a Homebrew használatával. Linuxon használja a disztribúciója csomagját az asztali verzióhoz. Windowson először ellenőrizze a támogatott terminálkörnyezeteket.

Indítás előtt készítse elő a modellazonosítót az aktuális modell-listából. A modellazonosító az a név, amelyet a modellszolgáltató egy adott modell azonosítására használ, és a teljes azonosítót kell kimásolnia a használatakor.

Telepítés és első indítás

Ha grafikus ablakot szeretne

Két dokumentált telepítési módszer létezik macOS-re:

Töltse le a telepítési oldalról. Az oldal macOS Silicon és macOS Intel verziókat biztosít. Letöltés után bontsa ki a zip fájlt, és futtassa a benne lévő alkalmazást.
Alternatívaként használja a Homebrew-t:

brew install --cask block-goose

Ez ugyanazt az alkalmazást tölti le, és a frissítéseket is kezeli.

Ha Apple Mac M3-at használ, és az alkalmazás megnyitása után nem jelenik meg ablak, ellenőrizze, hogy a ~/.config olvasható és írható-e. A goose ezt a könyvtárat használja a naplók írására.

A Linux asztali verziójához töltse le a telepítési oldalról. Az elérhető csomagok a DEB Ubuntu/Debianhoz, az RPM RHEL/Fedora-hoz és a Flatpak. Debianon vagy Ubuntun töltse le a DEB fájlt, nyissa meg a könyvtárat, ahová mentette, futtassa a sudo dpkg -i (filename).debparancsot, majd nyissa meg a goose-t az alkalmazásmenüből. Cserélje le a (filename) részt a tényleges fájlnévre.

A Windows asztali verziójához töltse le a telepítési oldalról, bontsa ki a zip fájlt, és futtassa a benne lévő alkalmazást.

Ha csak a terminálverziót szeretné

macOS-en és Linuxon futtassa:

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

Az interaktív konfiguráció kihagyásához a telepítés során adja hozzá a CONFIGURE=false változót a bash parancs elé:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
``` macOS-en futtathatja a következőt is:

```sh
brew install block-goose-cli

A telepített CLI frissítéséhez futtassa:

goose update

Windowson a következő három környezet egyike szükséges: Git Bash, amely a Git for Windows része és ajánlott; MSYS2; vagy a Windows 10/11-hez mellékelt PowerShell. Git Bash-ben és MSYS2-ben használja ugyanazt a download_cli.sh parancsot, mint fent. PowerShellben először töltse le a szkriptet, majd futtassa:

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

Ha azt a hibaüzenetet kapja, hogy a goose nem található a PATH-ban, kövesse a telepítési oldalt, és adja hozzá a ~/.local/bin vagy a %USERPROFILE%\.local\bin útvonalat az aktuális shell-konfigurációhoz, majd indítsa újra a terminált. A PATH azon könyvtárak halmaza, amelyekben a terminál programokat keres. Ha a telepítési könyvtár nincs benne, előfordulhat, hogy nem tudja futtatni a telepített programot a nevének közvetlen beírásával.

október 9-én a CLI verzió 1.54.0 volt. Alapértelmezés szerint a telepítőszkript a programot a ~/.local/binkönyvtárba helyezi. Ezt a könyvtárat módosíthatja a GOOSE_BIN_DIR környezeti változóval. Ha módosítja, a szkript nem frissíti automatikusan a shell-konfigurációt, és a terminál azt fogja jelenteni, hogy a könyvtár nincs a PATH-ban. Adja hozzá azt a könyvtárat a PATH-hoz, vagy futtassa a goose-t a teljes elérési útjával.

A goose első használatakor megkéri, hogy konfiguráljon egy Szolgáltatót. Kihagyhatja a beépített szolgáltatókat, és hozzáadhat egy egyéni Szolgáltatót a következő szakaszban leírtak szerint. A terminálban lépjen abba a könyvtárba, ahol dolgozni szeretne, és futtassa:

goose session

Csatlakozási értékek beszerzése az OmniProxyból

Készítse elő a címet, a kulcsot és a modellnevet a saját OmniProxy-példányából. Az egyéni Szolgáltató példája egy base_url végződésű /v1/chat/completionscímet használ, így ez az útmutató is ezt a formátumot követi:

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

Másolja ki a teljes modellnevet az aktuális OmniProxy-listából, beleértve a perjeleket is. 2026. október 9-én a szolgáltatói dokumentációban szereplő két referencia-azonosító a grok-4.7 a Grokhoz és a gpt-6-luna az OpenAI dokumentációjából.

A gpt-6-luna támogatja a Chat Completions-t; a függvényhívás a Chat Completions-ben csak akkor támogatott, ha a reasoning_effort értéke none. Ne másoljon olyan nevet, amely nem szerepel a listában.

Az eszköz konfigurálása

Az egyéni Szolgáltató OpenAI-, Anthropic- vagy Ollama-kompatibilis formátumot használhat. A kompatibilis formátum azt jelenti, hogy az eszköz egy közös API-specifikáció szerint küld kéréseket. Amikor az OmniProxyhoz csatlakozik, válassza az OpenAI Compatible lehetőséget.

Desktop

Kattintson a bal felső sarokban lévő gombra az oldalsáv megnyitásához.
Kattintson a Beállítások gombra.
Kattintson a Modellek gombra.
Kattintson a Szolgáltatók konfigurálása gombra.
Kattintson az Egyéni szolgáltató hozzáadása gombra az ablak alján.
A Szolgáltató típusa mezőben válassza az OpenAI Compatible lehetőséget. A Megjelenítendő nevet beállíthatja OmniProxy-ra. Írja be az előző szakaszból származó címet az API URL mezőbe. Ha kulcs szükséges, válassza az API-kulcsot igénylő opciót, és írja be az OmniProxy-kulcsát. Az Elérhető modellek mezőbe írja be a modellneveket, vesszővel elválasztva a több nevet.
Kattintson a Szolgáltató létrehozása gombra.

Az asztali verzió jelenleg nem tud egyéni kérésfejléceket definiálni ebben az ablakban. Ha kérésfejlécekre van szüksége, szerkessze a konfigurációs fájlt a Szolgáltató létrehozása után.

Terminál

Futtassa:

goose configure

Válassza az Egyéni szolgáltatók, majd az Egyéni szolgáltató hozzáadása lehetőséget. Az API típusa mezőben válassza az OpenAI Compatible lehetőséget, majd kövesse az utasításokat a név, az API URL, a kulcs szükségességének, a modellneveknek és a streamelési válaszok támogatásának megadásához.

Amikor manuálisan konfigurál Windowson, ha a kulcstartó hibát jelez, a telepítési utasítások szerint utasítsa el a kulcs mentését a kulcstartóban, és használjon helyette környezeti változót. Ezután futtassa újra a goose configure parancsot. A kulcstartó egy kis biztonságos tárolórendszer, amelyet az operációs rendszer titkok tárolására használ.

Konfigurációs fájl

A dokumentált könyvtárak a következők:

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

A fájlt a megadott példa alapján készítheti el. Cserélje le a nevet, a címet és a modelleket a saját értékeire. Tárolja a kulcsot a api_key_enváltal meghatározott környezeti változóban; ne írja be a valódi kulcsot a fájlba:

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

Tartsa meg a numerikus értéket a context_limitmezőhöz, ahogy a példában látható. A tényleges kontextuskorlát a modelltől és az OmniProxy-tól függ; ne kezelje a példában szereplő számot a modell hivatalos korlátjaként. Használat előtt futtassa:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

A munkakönyvtárba való belépés után futtassa:

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

Cserélje le a --model értékét a listából származó teljes azonosítóra. goose session nem rendelkezik start alparanccsal. Beállíthatja a --provider és a --model értékeket a GOOSE_PROVIDER és a GOOSE_MODEL környezeti változókon keresztül. Még ha az átjáró nem is érvényesíti a kulcsokat, a OMNIPROXY_API_KEY mezőnek akkor is rendelkeznie kell értékkel. Ez lehet egy csak a helyi számítógépen használt helyőrző karakterlánc. Ez a konfiguráció 2026. október 9-én sikeresen elolvasott egy fájlt a tesztelés során.

Ablak

Beállítások

Beállítások az oldalsávon
Modellek oldal
Egyéni szolgáltató hozzáadása

Terminál

goose configure

Válassza az Egyéni szolgáltatók lehetőséget
Majd válassza a hozzáadást
Válassza az OpenAI Compatible típust

Fájl

custom_providers

macOS-en és Linuxon a ~/.config alatt található
Windowson az APPDATA alatt található
Állítsa be a base_url-t a hivatalos példa szerint

Mindhárom módszer ugyanazt a típusú konfigurációt hozza létre. Válassza az OpenAI Compatible-t Szolgáltató típusként.

Ellenőrzés valódi feladattal

Nyisson meg egy normál fájlt tartalmazó könyvtárat, és futtassa a goose session parancsot az előző szakaszban leírtak szerint. Kérje meg, hogy olvassa el egy megadott fájl első sorát. A fájl tartalmát kell visszaadnia, nem csak azt, hogy a konfiguráció mentve lett.

Fájlok olvasásához vagy parancsok végrehajtásához a munkamenetnek szüksége van a Developer kiterjesztésre. A Developer kiterjesztés egy olyan eszközmodul, amely lehetővé teszi a goose számára a helyi fájlokkal és parancsokkal való munkát. Általában az alapértelmezett konfiguráció tartalmazza. Ha a goose azt mondja, hogy nincsenek fájleszközei, adja hozzá a következőket a parancshoz:

--with-builtin developer

Ne adja hozzá a --no-profilekapcsolót, mert az letiltja az alapértelmezett kiterjesztéseket.

október 9-én a tesztelés során a goose 1.54.0 sikeresen elolvasta a megadott fájl első sorát. Az első válasz körülbelül egy percet vehet igénybe.

Ezután ellenőrizze az OmniProxy kérésnaplóit a forrás és a modellnév megerősítéséhez.

Indítás

Megnyílik egy munkamenet

goose session
A Szolgáltató az imént hozzáadott
A modellnév szerepel a listában

Feladat

Ténylegesen elvégezte a feladatot

Például listázza az aktuális könyvtárat
Tekintse át a válaszát
Ne hagyatkozzon csak a sikeres mentésre

Naplók

Látható az átjáróban

Használja a dokumentációs példában szereplő címet
Ne tegye a kulcsot a tárolóba
A modellazonosító egyezik a listával

A Szolgáltató mentése után erősítse meg egy valódi munkamenettel.

Gyakori hibák

A goose parancs nem található: Adja hozzá a telepítési könyvtárat a PATH-hoz a telepítési oldalon leírtak szerint, majd indítsa újra a terminált.
Nem jelenik meg ablak az asztali verzióban M3 Macen: Ellenőrizze a ~/.configolvasási és írási engedélyeit.
A kulcstartó hiba: Ne mentse a kulcsot a kulcstartóban; használjon helyette környezeti változót.
A modell nem szerepel a listában: Az asztali verzióban válassza az Egyéni modell használata lehetőséget, és írja be manuálisan a modellnevet. goose configure nem tud egyéni modellnevet elfogadni. Terminálhasználathoz váltson az asztali verzióra, vagy szerkessze a GOOSE_MODEL fájlt közvetlenül a konfigurációban.
A cím nem érhető el: Erősítse meg, hogy az API URL a /v1/chat/completionsvégződéssel ér véget, mint a példában, és hogy az OmniProxy fut.
Azt mondja, hogy nem tud fájlokat olvasni: Adja hozzá a Developer kiterjesztést, és ne használja a --no-profilekapcsolót.
Azt adja vissza, hogy unsupported Responses role: system: A cím általában helyes. Váltson egy másik teljes azonosítóra a modell-listából.

Hivatalos hivatkozások

A telepítésért lásd: Install goose. Az egyéni Szolgáltatókért lásd: goose providers. A példákban használt modellazonosítókért lásd: az xAI models page és a GPT-6 Luna.

Helyettesítse az összes helykitöltőt a saját OmniProxy-konfigurációjából származó értékekkel. Soha ne publikáljon valódi kulcsot.

Egy mentett eredmény vagy HTTP 200 önmagában nem bizonyítja a teljes ügynök kompatibilitást. Ellenőrizze a forrást és a modellt az OmniProxy hívásnaplójában.

Hivatalos források · goose ↗