„goose“ diegimas ir pasirinktinio teikėjo konfigūravimas

„goose“ yra bendrosios paskirties DI asistentas, veikiantis jūsų kompiuteryje. Be kodavimo, jis gali tvarkyti tyrimus, rašymą, automatizavimą ir duomenų organizavimą. Galite jį naudoti per darbalaukio programą, terminalą ar API, o darbalaukio ir terminalo versijos dalijasi ta pačia modelio konfigūracija. Jis tinka pasikartojančioms kodavimo užduotims, taip pat gali prisijungti prie „GitHub“, duomenų bazių ir failų.

Prieš pradedant

„goose“ siūlo du diegimo būdus: darbalaukio ir CLI. Darbalaukio versija yra grafinė versija su langu, o CLI naudojama įvedant komandas terminale. Abi dalijasi ta pačia pagrindine konfigūracija, įskaitant teikėją (Provider) ir modelį. Teikėjas yra ryšio konfigūracija, nurodanti „goose“, kurią modelio paslaugą naudoti.

Norite lango

„goose Desktop“

• Atsisiųskite „zip“ „macOS“ sistemoje
• Arba naudokite „brew cask“
• Naudokite diegimo paketą „Linux“ sistemoje

Tik terminalas

„goose CLI“

• download_cli.sh
• Arba „Homebrew CLI“
• Tada vykdykite „goose session“

„Windows“

Pirmiausia pasirinkite aplinką

• „Git Bash“ arba „MSYS2“
• Taip pat galite naudoti „PowerShell“
• Jei komanda nerasta, pridėkite ją prie PATH

Prieš pradedant, paruoškite modelio ID iš dabartinio modelių sąrašo. Modelio ID yra pavadinimas, kurį modelio paslauga naudoja konkrečiam modeliui identifikuoti, ir naudodami jį privalote nukopijuoti visą ID.

Diegimas ir pirmasis paleidimas

Jei norite grafinio lango

Yra du dokumentuoti diegimo būdai „macOS“ sistemai:

• Atsisiųskite jį iš diegimo puslapio. Puslapyje pateikiamos „macOS Silicon“ ir „macOS Intel“ versijos. Atsisiuntę išskleiskite „zip“ failą ir paleiskite viduje esančią programą.
• Arba naudokite „Homebrew“:

brew install --cask block-goose

Tai atsisiunčia tą pačią programą ir taip pat gali tvarkyti atnaujinimus.

Jei naudojate „Apple Mac M3“ ir atidarius programą langas nepasirodo, patikrinkite, ar ~/.config yra skaitomas ir įrašomas. „goose“ naudoja šį katalogą žurnalams įrašyti.

„Linux“ darbalaukio versijai atsisiųskite ją iš diegimo puslapio. Galimi paketai yra „DEB“ („Ubuntu“/„Debian“), „RPM“ („RHEL“/„Fedora“) ir „Flatpak“. „Debian“ arba „Ubuntu“ sistemoje atsisiųskite „DEB“ failą, atidarykite katalogą, kuriame jis buvo išsaugotas, vykdykite sudo dpkg -i (filename).deb, tada atidarykite „goose“ iš programų meniu. Pakeiskite (filename) tikruoju failo pavadinimu.

„Windows“ darbalaukio versijai atsisiųskite ją iš diegimo puslapio, išskleiskite „zip“ failą ir paleiskite viduje esančią programą.

Jei norite tik terminalo versijos

„macOS“ ir „Linux“ sistemose vykdykite:

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

Norėdami praleisti interaktyvią konfigūraciją diegimo metu, pridėkite CONFIGURE=false prieš bash:

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

„macOS“ sistemoje taip pat galite vykdyti:

brew install block-goose-cli

Norėdami atnaujinti įdiegtą CLI, vykdykite:

goose update

„Windows“ sistemoje reikalinga viena iš šių trijų aplinkų: „Git Bash“, kuri įtraukta į „Git for Windows“ ir pažymėta kaip rekomenduojama; „MSYS2“; arba „PowerShell“, įtraukta į „Windows 10/11“. „Git Bash“ ir „MSYS2“ naudokite tą pačią download_cli.sh komandą, parodytą aukščiau. „PowerShell“ sistemoje pirmiausia atsisiųskite scenarijų ir tada vykdykite:

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

Jei jums pasakyta, kad „goose“ nėra PATH, vadovaukitės diegimo puslapiu ir pridėkite ~/.local/bin arba %USERPROFILE%\.local\bin prie dabartinės apvalkalo (shell) konfigūracijos, tada iš naujo atidarykite terminalą. PATH yra katalogų rinkinys, kuriame terminalas ieško programų. Jei diegimo katalogas neįtrauktas, gali nepavykti paleisti įdiegtos programos tiesiogiai įvedus jos pavadinimą.

2026-10-09 duomenimis, CLI versija buvo 1.54.0. Pagal numatytuosius nustatymus diegimo scenarijus patalpina programą į ~/.local/bin. Šį katalogą galite pakeisti naudodami GOOSE_BIN_DIR aplinkos kintamąjį. Jei jį pakeisite, scenarijus automatiškai neatnaujins apvalkalo konfigūracijos, o terminalas praneš, kad katalogas nėra PATH. Pridėkite tą katalogą prie PATH arba vykdykite „goose“ naudodami visą jos kelią.

Pirmą kartą naudodami „goose“, ji paprašys sukonfigūruoti teikėją (Provider). Galite praleisti integruotus teikėjus ir pridėti pasirinktinį teikėją, kaip aprašyta kitame skyriuje. Terminale pereikite į katalogą, kuriame norite dirbti, ir vykdykite:

goose session

Gaukite ryšio vertes iš „OmniProxy“

Paruoškite adresą, raktą ir modelio pavadinimą iš savo „OmniProxy“ egzemplioriaus. Pasirinktinio teikėjo pavyzdyje naudojamas base_url besibaigiantis /v1/chat/completions, todėl šiame vadove laikomasi to paties formato:

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

Nukopijuokite visą modelio pavadinimą iš dabartinio „OmniProxy“ sąrašo, įskaitant visus pasviruosius brūkšnius. 2026-10-09 duomenimis, du nuorodų ID teikėjo dokumentacijoje buvo grok-4.7 „Grok“ ir gpt-6-luna iš „OpenAI“ dokumentacijos. gpt-6-luna palaiko „Chat Completions“; funkcijų iškvietimas „Chat Completions“ palaikomas tik tada, kai reasoning_effort nustatyta į none. Nekopijuokite pavadinimo, kurio nėra sąraše.

Įrankio konfigūravimas

Pasirinktinis teikėjas gali naudoti „OpenAI“, „Anthropic“ arba „Ollama“ suderinamą formatą. Suderinamas formatas reiškia, kad įrankis siunčia užklausas pagal bendrą API specifikaciją. Jungdamiesi prie „OmniProxy“, pasirinkite OpenAI Compatible.

Darbalaukis

1. Spustelėkite mygtuką viršutiniame kairiajame kampe, kad atidarytumėte šoninę juostą.
2. Spustelėkite Settings.
3. Spustelėkite Models.
4. Spustelėkite Configure providers.
5. Spustelėkite Add Custom Provider lango apačioje.
6. Skiltyje „Provider Type“ pasirinkite OpenAI Compatible. Galite nustatyti „Display Name“ į „OmniProxy“. Įveskite adresą iš ankstesnio skyriaus į „API URL“. Jei reikalingas raktas, pasirinkite parinktį, kuriai reikia API rakto, ir įveskite savo „OmniProxy“ raktą. Skiltyje „Available Models“ įveskite modelių pavadinimus, atskirdami kelis pavadinimus kableliais.
7. Spustelėkite Create Provider.

Darbalaukio versija šiuo metu šiame lange negali apibrėžti pasirinktinių užklausų antraščių. Jei jums reikia užklausų antraščių, redaguokite konfigūracijos failą sukūrę teikėją.

Terminalas

Vykdykite:

goose configure

Pasirinkite Custom Providers, tada pasirinkite Add A Custom Provider. Skiltyje „API Type“ pasirinkite OpenAI Compatible, tada vykdykite raginimus įvesti pavadinimą, API URL, ar reikalingas raktas, modelių pavadinimus ir ar palaikomi srautiniai atsakymai.

Konfigūruojant rankiniu būdu „Windows“ sistemoje, jei raktų pakabukas (keychain) praneša apie klaidą, diegimo instrukcijose nurodoma atsisakyti rakto išsaugojimo raktų pakabuke ir vietoj to naudoti aplinkos kintamąjį. Tada vėl vykdykite goose configure . Raktų pakabukas yra nedidelė saugi saugojimo sistema, kurią operacinė sistema naudoja paslaptims saugoti.

Konfigūracijos failas

Dokumentuoti katalogai yra:

• „macOS“ ir „Linux“: ~/.config/goose/custom_providers/
• „Windows“: %APPDATA%\Block\goose\config\custom_providers\

Galite remtis pateiktu pavyzdžiu. Pakeiskite pavadinimą, adresą ir modelius savo vertėmis. Saugokite raktą aplinkos kintamajame, nurodytame api_key_env; nerašykite tikro rakto į failą:

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

Išlaikykite skaitinę vertę context_limit, kaip parodyta pavyzdyje. Tikroji konteksto riba priklauso nuo modelio ir „OmniProxy“; nelaikykite pavyzdžio skaičiaus oficialia modelio riba. Prieš naudodami, vykdykite:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Įėję į darbo katalogą, vykdykite:

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

Pakeiskite --model vertę visu ID iš sąrašo. goose session neturi start subkomandos. Taip pat galite nustatyti --provider ir --model per GOOSE_PROVIDER ir GOOSE_MODEL aplinkos kintamuosius. Net jei šliuzas nepatvirtina raktų, OMNIPROXY_API_KEY vis tiek turi turėti vertę. Tai gali būti vietos rezervavimo ženklų eilutė, naudojama tik jūsų vietiniame kompiuteryje. Ši konfigūracija sėkmingai perskaitė failą bandymų metu 2026-10-09.

Langas

Nustatymai

• Nustatymai šoninėje juostoje
• Modelių puslapis
• Pridėti pasirinktinį teikėją

Terminalas

goose configure

• Pasirinkite pasirinktinius teikėjus
• Tada pasirinkite pridėti
• Pasirinkite „OpenAI Compatible“ kaip tipą

Failas

custom_providers

• „macOS“ ir „Linux“ sistemose jis yra po ~/.config
• „Windows“ sistemoje jis yra po APPDATA
• Nustatykite base_url pagal oficialų pavyzdį

Patikrinimas su tikra užduotimi

Atidarykite katalogą, kuriame yra įprastas failas, ir vykdykite goose session kaip parodyta ankstesniame skyriuje. Paprašykite jo perskaityti pirmąją nurodyto failo eilutę. Jis turėtų grąžinti failo turinį, o ne tik pasakyti, kad konfigūracija buvo išsaugota.

Norint skaityti failus ar vykdyti komandas, seansui reikia „Developer“ plėtinio. „Developer“ plėtinys yra įrankių modulis, leidžiantis „goose“ dirbti su vietiniais failais ir komandomis. Jis paprastai įtrauktas į numatytąją konfigūraciją. Jei „goose“ sako, kad neturi failų įrankių, pridėkite prie komandos:

--with-builtin developer

Taip pat nepridėkite --no-profile, nes ši parinktis išjungia numatytuosius plėtinius.

Bandymų metu 2026-10-09 „goose 1.54.0“ sėkmingai perskaitė pirmąją nurodyto failo eilutę. Pirmasis atsakymas gali užtrukti apie vieną minutę.

Tada patikrinkite „OmniProxy“ užklausų žurnalus, kad patvirtintumėte šaltinį ir modelio pavadinimą.

Paleidimas

Seansas atsidaro

• goose session
• Teikėjas yra tas, kuris ką tik buvo pridėtas
• Modelio pavadinimas yra sąraše

Užduotis

Ji iš tikrųjų užbaigė užduotį

• Pavyzdžiui, išvardykite dabartinį katalogą
• Peržiūrėkite jos atsakymą
• Nepasikliaukite tik sėkmingu išsaugojimu

Žurnalai

Matomi šliuze

• Naudokite adresą iš dokumentacijos pavyzdžio
• Nedėkite rakto į saugyklą
• Modelio ID atitinka sąrašą

Dažnos klaidos

• goose komanda nerasta: Pridėkite diegimo katalogą prie PATH, kaip aprašyta diegimo puslapyje, tada iš naujo atidarykite terminalą.
• Darbalaukio versijoje „M3 Mac“ kompiuteryje langas nepasirodo: Patikrinkite skaitymo ir rašymo teises ~/.config.
• Raktų pakabukas nepavyksta: Neišsaugokite rakto raktų pakabuke; vietoj to naudokite aplinkos kintamąjį.
• Modelio nėra sąraše: Darbalaukio versijoje pasirinkite Use custom model ir įveskite modelio pavadinimą rankiniu būdu. goose configure negali priimti pasirinktinio modelio pavadinimo. Terminalo naudojimui perjunkite į darbalaukio versiją arba redaguokite GOOSE_MODEL tiesiogiai konfigūracijoje.
• Adresas nepasiekiamas: Patvirtinkite, kad API URL baigiasi /v1/chat/completions, kaip pavyzdyje, ir kad „OmniProxy“ veikia.
• Sako, kad negali skaityti failų: Pridėkite „Developer“ plėtinį ir nenaudokite --no-profile.
• Grąžina unsupported Responses role: system: Adresas paprastai teisingas. Perjunkite į kitą visą ID iš modelių sąrašo.

Oficialios nuorodos

Diegimą žr. „Install goose“. Pasirinktinius teikėjus žr. „goose providers“. Pavyzdžiuose naudojamus modelių ID žr. „xAI models page“ ir „GPT-6 Luna“.

Pakeiskite visus rezervuotus laukelius reikšmėmis iš savo „OmniProxy“ konfigūracijos. Niekada neskelbkite tikro rakto.

Vien išsaugoto rezultato ar HTTP 200 nepakanka visapusiškam agento suderinamumui įrodyti. Patikrinkite šaltinį ir modelį „OmniProxy“ užklausos įraše.

Oficialūs šaltiniai · goose ↗