goose'i installimine ja kohandatud teenusepakkuja seadistamine

goose on üldotstarbeline AI-assistent, mis töötab teie arvutis. Lisaks kodeerimisele saab see hakkama uurimistöö, kirjutamise, automatiseerimise ja andmete korraldamisega. Saate seda kasutada töölauarakenduse, terminali või API kaudu ning töölaua- ja terminaliversioonid jagavad sama mudeli konfiguratsiooni. See sobib korduvateks kodeerimisülesanneteks ja saab ühenduda ka GitHubi, andmebaaside ja failidega.

Enne alustamist

goose pakub kahte installimisvõimalust: Desktop ja CLI. Desktop on graafiline versioon aknaga, samas kui CLI-d kasutatakse terminalis käskude sisestamisega. Mõlemad jagavad sama põhikonfiguratsiooni, sealhulgas teenusepakkujat ja mudelit. Teenusepakkuja on ühenduse konfiguratsioon, mis ütleb goose’ile, millist mudeliteenust kasutada.

Soovite akent

goose Desktop

• Laadige alla zip macOS-is
• Või kasutage brew cask'i
• Kasutage Linuxis installipaketti

Ainult terminal

goose CLI

• download_cli.sh
• Või Homebrew CLI
• Seejärel käivitage goose session

Windows

Valige esmalt keskkond

• Git Bash või MSYS2
• Võite kasutada ka PowerShelli
• Kui käsku ei leita, lisage see PATH-i

Enne alustamist valmistage ette mudeli ID praegusest mudelite loendist. Mudeli ID on nimi, mida mudeliteenus kasutab konkreetse mudeli tuvastamiseks, ja selle kasutamisel peate kopeerima täieliku ID.

Installimine ja esmakordne käivitamine

Kui soovite graafilist akent

macOS-i jaoks on dokumenteeritud kaks installimismeetodit:

• Laadige see alla installimislehelt. Leht pakub macOS Silicon ja macOS Intel versioone. Pärast allalaadimist ekstraktige zip-fail ja käivitage rakendus selle sees.
• Teise võimalusena kasutage Homebrew’d:

brew install --cask block-goose

See laadib alla sama rakenduse ja saab hallata ka värskendusi.

Kui kasutate Apple Mac M3-e ja pärast rakenduse avamist akent ei ilmu, kontrollige, kas ~/.config on loetav ja kirjutatav. goose kasutab seda kataloogi logide kirjutamiseks.

Linuxi töölauaversiooni jaoks laadige see alla installimislehelt. Saadaolevad paketid on DEB Ubuntu/Debiani jaoks, RPM RHEL/Fedora jaoks ja Flatpak. Debiani või Ubuntu puhul laadige alla DEB-fail, avage kataloog, kuhu see salvestati, käivitage sudo dpkg -i (filename).debja seejärel avage goose rakenduste menüüst. Asendage (filename) tegeliku failinimega.

Windowsi töölauaversiooni jaoks laadige see alla installimislehelt, ekstraktige zip-fail ja käivitage rakendus selle sees.

Kui soovite ainult terminaliversiooni

macOS-is ja Linuxis käivitage:

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

Interaktiivse konfiguratsiooni vahelejätmiseks installimise ajal lisage CONFIGURE=false enne bash:

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

macOS-is saate käivitada ka:

brew install block-goose-cli

Installitud CLI värskendamiseks käivitage:

goose update

Windowsis on vajalik üks järgmistest kolmest keskkonnast: Git Bash, mis on kaasas Git for Windowsiga ja märgitud soovitatavaks; MSYS2; või Windows 10/11-ga kaasas olev PowerShell. Git Bashis ja MSYS2-s kasutage sama download_cli.sh käsku, mida on näidatud ülal. PowerShellis laadige skript esmalt alla ja seejärel käivitage:

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

Kui teile öeldakse, et goose pole PATH-is, järgige installimislehte ja lisage ~/.local/bin või %USERPROFILE%\.local\bin praegusesse shelli konfiguratsiooni, seejärel avage terminal uuesti. PATH on kataloogide kogum, mida terminal programmide otsimiseks kasutab. Kui installikataloogi pole kaasatud, ei pruugi te installitud programmi käivitada selle nime otse sisestades.

2026-10-09 seisuga oli CLI versioon 1.54.0. Vaikimisi paigutab installimisskript programmi kataloogi ~/.local/bin. Saate seda kataloogi muuta keskkonnamuutujaga GOOSE_BIN_DIR . Kui muudate seda, ei värskenda skript automaatselt shelli konfiguratsiooni ja terminal teatab, et kataloogi pole PATH-is. Lisage see kataloog PATH-i või käivitage goose selle täielikku teed kasutades.

goose’i esmakordsel kasutamisel palub see teil seadistada teenusepakkuja. Saate sisseehitatud teenusepakkujad vahele jätta ja lisada kohandatud teenusepakkuja, nagu on kirjeldatud järgmises jaotises. Terminalis navigeerige kataloogi, kus soovite töötada, ja käivitage:

goose session

Ühenduse väärtuste hankimine OmniProxyst

Valmistage ette aadress, võti ja mudeli nimi oma OmniProxy eksemplarist. Kohandatud teenusepakkuja näites kasutatav base_url lõpeb pöördusega /v1/chat/completions, seega järgib see juhend sama vormingut:

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

Kopeerige täielik mudeli nimi praegusest OmniProxy loendist, sealhulgas kõik kaldkriipsud. 2026-10-09 seisuga olid teenusepakkuja dokumentatsioonis kaks viite-ID-d grok-4.7 Groki jaoks ja gpt-6-luna OpenAI dokumentatsioonist. gpt-6-luna toetab Chat Completionsi; funktsioonide kutsumine Chat Completionsis on toetatud ainult siis, kui reasoning_effort on määratud väärtusele none. Ärge kopeerige nime, mida loendis ei esine.

Tööriista seadistamine

Kohandatud teenusepakkuja saab kasutada OpenAI-, Anthropic- või Ollama-ühilduvat vormingut. Ühilduv vorming tähendab, et tööriist saadab päringuid vastavalt tavalisele API spetsifikatsioonile. OmniProxyle ühendamisel valige OpenAI Compatible.

Desktop

1. Klõpsake külgriba avamiseks vasakus ülanurgas oleval nupul.
2. Klõpsake Settings.
3. Klõpsake Models.
4. Klõpsake Configure providers.
5. Klõpsake akna allosas Add Custom Provider.
6. Teenusepakkuja tüübiks valige OpenAI Compatible. Saate määrata kuvatavaks nimeks OmniProxy. Sisestage API URL-i väljale aadress eelmisest jaotisest. Kui võti on vajalik, valige API-võtit nõudev valik ja sisestage oma OmniProxy võti. Jaotises Available Models sisestage mudelite nimed, eraldades mitu nime komadega.
7. Klõpsake Create Provider.

Töölauaversioon ei saa praegu selles aknas kohandatud päringupäiseid määratleda. Kui vajate päringupäiseid, muutke pärast teenusepakkuja loomist konfiguratsioonifaili.

Terminal

Käivitage:

goose configure

Valige Custom Providers, seejärel valige Add A Custom Provider. API tüübiks valige OpenAI Compatible, seejärel järgige juhiseid nime, API URL-i, võtme vajalikkuse, mudelite nimede ja voogesituse vastuste toetamise sisestamiseks.

Windowsis käsitsi seadistamisel, kui võtmehoidja teatab veast, ütlevad installimisjuhised, et võtit ei tohiks võtmehoidjasse salvestada ja selle asemel tuleks kasutada keskkonnamuutujat. Seejärel käivitage goose configure uuesti. Võtmehoidja on väike turvaline salvestussüsteem, mida operatsioonisüsteem kasutab saladuste hoidmiseks.

Konfiguratsioonifail

Dokumenteeritud kataloogid on:

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

Saate faili põhineda esitatud näitel. Asendage nimi, aadress ja mudelid oma väärtustega. Salvestage võti keskkonnamuutujasse, mis on määratud api_key_env; ärge kirjutage tegelikku võtit faili:

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

Hoidke numbriline väärtus context_limitjaoks, nagu näites näidatud. Tegelik konteksti piirang sõltub mudelist ja OmniProxyst; ärge käsitlege näite numbrit mudeli ametliku piiranguna. Enne kasutamist käivitage:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Pärast töökataloogi sisestamist käivitage:

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

Asendage väärtus --model täieliku ID-ga loendist. goose session ei ole start alamkäsku. Saate määrata ka --provider ja --model läbi GOOSE_PROVIDER ja GOOSE_MODEL keskkonnamuutujate. Isegi kui lüüs võtmeid ei valideeri, OMNIPROXY_API_KEY peab siiski olema väärtus. See võib olla kohahoidja string, mida kasutatakse ainult teie kohalikus arvutis. See konfiguratsioon luges 2026-10-09 testimisel edukalt faili.

Aken

Seaded

• Seaded külgribal
• Mudelite leht
• Lisa kohandatud teenusepakkuja

Terminal

goose configure

• Valige kohandatud teenusepakkujad
• Seejärel valige lisa
• Valige tüübiks OpenAI Compatible

Fail

custom_providers

• macOS-is ja Linuxis on see ~/.config all
• Windowsis on see APPDATA all
• Määrake base_url vastavalt ametlikule näitele

Kontrollimine reaalse ülesandega

Avage kataloog, mis sisaldab tavalist faili, ja käivitage goose session nagu eelmises jaotises näidatud. Paluge sellel lugeda teie määratud faili esimest rida. See peaks tagastama faili sisu, mitte ainult ütlema, et konfiguratsioon salvestati.

Failide lugemiseks või käskude täitmiseks vajab seanss arendaja laiendust. Arendaja laiendus on tööriistamoodul, mis võimaldab goose’il töötada kohalike failide ja käskudega. See on üldiselt kaasatud vaikimisi konfiguratsiooni. Kui goose ütleb, et tal pole failitööriistu, lisage käsule järgmine:

--with-builtin developer

Ärge lisage ka --no-profile, sest see valik keelab vaikimisi laiendused.

2026-10-09 testimisel luges goose 1.54.0 edukalt määratud faili esimest rida. Esimene vastus võib võtta umbes ühe minuti.

Seejärel kontrollige OmniProxy päringuloge, et kinnitada allikat ja mudeli nime.

Käivitamine

Seanss avaneb

• goose session
• Teenusepakkuja on see, mis just lisati
• Mudeli nimi on loendis

Ülesanne

See täitis ülesande tegelikult

• Näiteks loetlege praegune kataloog
• Vaadake selle vastust
• Ärge lootke ainult edukale salvestamisele

Logid

Nähtav lüüsis

• Kasutage dokumentatsiooni näites olevat aadressi
• Ärge pange võtit hoidlasse
• Mudeli ID ühtib loendiga

Levinud vead

• goose käsku ei leita: Lisage installikataloog PATH-i, nagu on kirjeldatud installimislehel, seejärel avage terminal uuesti.
• Töölauaversioonis M3 Macil akent ei ilmu: Kontrollige lugemis- ja kirjutamisõigusi ~/.config.
• Võtmehoidja ebaõnnestub: Ärge salvestage võtit võtmehoidjasse; kasutage selle asemel keskkonnamuutujat.
• Mudelit pole loendis: Töölauaversioonis valige Use custom model ja sisestage mudeli nimi käsitsi. goose configure ei saa aktsepteerida kohandatud mudeli nime. Terminali kasutamiseks lülituge töölauaversioonile või muutke GOOSE_MODEL otse konfiguratsioonis.
• Aadress pole kättesaadav: Veenduge, et API URL lõpeb /v1/chat/completions, nagu näites, ja et OmniProxy töötab.
• See ütleb, et ei saa faile lugeda: Lisage arendaja laiendus ja ärge kasutage --no-profile.
• See tagastab unsupported Responses role: system: Aadress on tavaliselt õige. Lülituge teisele täielikule ID-le mudeliloendist.

Ametlikud viited

Installimise kohta vaadake Installige goose. Kohandatud teenusepakkujate kohta vaadake goose’i teenusepakkujad. Näidetes kasutatud mudeli ID-de kohta vaadake xAI mudelite lehte ja GPT-6 Luna.

Asenda iga lünk oma OmniProxy seadistuse väärtustega. Ära kunagi avalda tõelist võtit.

Salvestatud tulemus või HTTP 200 iseenesest ei tõesta täielikku Agenti ühilduvust. Vaata allikat ja mudelit OmniProxy päringukirjetes.

Ametlikud allikad · goose ↗