goose instalēšana un pielāgota pakalpojumu sniedzēja konfigurēšana

goose ir vispārēja mērķa AI palīgs, kas darbojas jūsu datorā. Papildus kodēšanai tas var apstrādāt pētniecību, rakstīšanu, automatizāciju un datu organizēšanu. Varat to izmantot, izmantojot darbvirsmas lietotni, termināli vai API, un darbvirsmas un termināļa versijas koplieto vienu un to pašu modeļa konfigurāciju. Tas ir piemērots atkārtotiem kodēšanas uzdevumiem un var arī izveidot savienojumu ar GitHub, datubāzēm un failiem.

Pirms sākat

goose piedāvā divas instalēšanas iespējas: Desktop un CLI. Desktop ir grafiskā versija ar logu, savukārt CLI tiek izmantota, ievadot komandas terminālī. Abas koplieto vienu un to pašu pamata konfigurāciju, ieskaitot pakalpojumu sniedzēju (Provider) un modeli. Pakalpojumu sniedzējs ir savienojuma konfigurācija, kas pasaka goose, kuru modeļa pakalpojumu izmantot.

Vēlaties logu

goose Desktop

Lejupielādējiet zip failu macOS
Vai izmantojiet brew cask
Izmantojiet instalētāja pakotni Linux

Tikai terminālis

goose CLI

download_cli.sh
Vai Homebrew CLI
Pēc tam palaidiet goose session

Windows

Vispirms izvēlieties vidi

Git Bash vai MSYS2
Varat arī izmantot PowerShell
Ja komanda nav atrasta, pievienojiet to PATH

macOS sistēmā varat to instalēt, lejupielādējot lietotni vai izmantojot Homebrew. Linux sistēmā izmantojiet savas izplatīšanas pakotni darbvirsmas versijai. Windows sistēmā vispirms pārbaudiet atbalstītās termināļa vides.

Pirms sākat, sagatavojiet modeļa ID no pašreizējā modeļu saraksta. Modeļa ID ir nosaukums, ko modeļa pakalpojums izmanto, lai identificētu konkrētu modeli, un, to izmantojot, jums ir jānokopē pilns ID.

Instalēšana un pirmā palaišana

Ja vēlaties grafisko logu

Ir divas dokumentētas instalēšanas metodes macOS:

Lejupielādējiet to no instalēšanas lapas. Lapa nodrošina macOS Silicon un macOS Intel versijas. Pēc lejupielādes izņemiet zip failu un palaidiet lietojumprogrammu iekšpusē.
Alternatīvi izmantojiet Homebrew:

brew install --cask block-goose

Tas lejupielādē to pašu lietojumprogrammu un var arī apstrādāt atjauninājumus.

Ja izmantojat Apple Mac M3 un pēc lietotnes atvēršanas logs neparādās, pārbaudiet, vai ~/.config ir lasāms un rakstāms. goose izmanto šo direktoriju žurnālu rakstīšanai.

Linux darbvirsmas versijai lejupielādējiet to no instalēšanas lapas. Pieejamās pakotnes ir DEB Ubuntu/Debian, RPM RHEL/Fedora un Flatpak. Debian vai Ubuntu lejupielādējiet DEB failu, atveriet direktoriju, kurā tas tika saglabāts, palaidiet sudo dpkg -i (filename).debun pēc tam atveriet goose no lietojumprogrammu izvēlnes. Aizstājiet (filename) ar faktisko faila nosaukumu.

Windows darbvirsmas versijai lejupielādējiet to no instalēšanas lapas, izņemiet zip failu un palaidiet lietojumprogrammu iekšpusē.

Ja vēlaties tikai termināļa versiju

macOS un Linux sistēmās palaidiet:

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

Lai instalēšanas laikā izlaistu interaktīvo konfigurāciju, pievienojiet CONFIGURE=false pirms bash:

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

macOS sistēmā varat arī palaist:

brew install block-goose-cli

Lai atjauninātu instalētu CLI, palaidiet:

goose update

Windows sistēmā ir nepieciešama viena no šīm trim vidēm: Git Bash, kas ir iekļauta Git for Windows un atzīmēta kā ieteicama; MSYS2; vai PowerShell, kas iekļauta Windows 10/11. Git Bash un MSYS2 izmantojiet to pašu download_cli.sh komandu, kas parādīta iepriekš. PowerShell vispirms lejupielādējiet skriptu un pēc tam palaidiet to:

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

Ja jums tiek paziņots, ka goose nav PATH, izpildiet instalēšanas lapas norādījumus un pievienojiet ~/.local/bin vai %USERPROFILE%\.local\bin pašreizējai čaulas konfigurācijai, pēc tam atkārtoti atveriet termināli. PATH ir direktoriju kopa, kurā terminālis meklē programmas. Ja instalēšanas direktorija nav iekļauta, iespējams, nevarēsit palaist instalētu programmu, tieši ievadot tās nosaukumu.

Uz 2026-10-09 CLI versija bija 1.54.0. Pēc noklusējuma instalēšanas skripts ievieto programmu mapē ~/.local/bin. Varat mainīt šo direktoriju ar GOOSE_BIN_DIR vides mainīgo. Ja to mainīsit, skripts automātiski neatjauninās čaulas konfigurāciju, un terminālis ziņos, ka direktorija nav PATH. Pievienojiet šo direktoriju PATH vai palaidiet goose, izmantojot tās pilno ceļu.

Pirmo reizi izmantojot goose, tā lūgs konfigurēt pakalpojumu sniedzēju (Provider). Varat izlaist iebūvētos pakalpojumu sniedzējus un pievienot pielāgotu pakalpojumu sniedzēju, kā aprakstīts nākamajā sadaļā. Terminālī dodieties uz direktoriju, kurā vēlaties strādāt, un palaidiet:

goose session

Savienojuma vērtību iegūšana no OmniProxy

Sagatavojiet adresi, atslēgu un modeļa nosaukumu no savas OmniProxy instances. Pielāgotā pakalpojumu sniedzēja piemērā tiek izmantots base_url kas beidzas ar /v1/chat/completions, tāpēc šī rokasgrāmata ievēro to pašu formātu:

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

Nokopējiet pilnu modeļa nosaukumu no pašreizējā OmniProxy saraksta, ieskaitot visas slīpsvītras. Uz 2026-10-09 divi atsauces ID pakalpojumu sniedzēja dokumentācijā bija grok-4.7 Grok un gpt-6-luna no OpenAI dokumentācijas. gpt-6-luna atbalsta Chat Completions; funkciju izsaukšana (function calling) Chat Completions tiek atbalstīta tikai tad, ja reasoning_effort ir iestatīts uz none. Nekopējiet nosaukumu, kas neparādās sarakstā.

Rīka konfigurācijas ievadīšana

Pielāgotais pakalpojumu sniedzējs var izmantot OpenAI, Anthropic vai Ollama saderīgu formātu. Saderīgs formāts nozīmē, ka rīks sūta pieprasījumus saskaņā ar kopēju API specifikāciju. Izveidojot savienojumu ar OmniProxy, atlasiet OpenAI Compatible.

Desktop

Noklikšķiniet uz pogas augšējā kreisajā stūrī, lai atvērtu sānjoslu.
Noklikšķiniet uz Settings.
Noklikšķiniet uz Models.
Noklikšķiniet uz Configure providers.
Noklikšķiniet uz Add Custom Provider loga apakšā.
Pakalpojumu sniedzēja tipam (Provider Type) atlasiet OpenAI Compatible. Varat iestatīt Display Name uz OmniProxy. API URL ievadiet adresi no iepriekšējās sadaļas. Ja ir nepieciešama atslēga, atlasiet opciju, kurai nepieciešama API atslēga, un ievadiet savu OmniProxy atslēgu. Sadaļā Available Models ievadiet modeļu nosaukumus, atdalot vairākus nosaukumus ar komatiem.
Noklikšķiniet uz Create Provider.

Darbvirsmas versija pašlaik šajā logā nevar definēt pielāgotus pieprasījuma galvenes (request headers). Ja jums ir nepieciešamas pieprasījuma galvenes, pēc pakalpojumu sniedzēja izveidošanas rediģējiet konfigurācijas failu.

Terminālis

Palaidiet:

goose configure

Atlasiet Custom Providers, pēc tam atlasiet Add A Custom Provider. API tipam atlasiet OpenAI Compatible, pēc tam izpildiet uzvednes, lai ievadītu nosaukumu, API URL, vai ir nepieciešama atslēga, modeļu nosaukumus un vai tiek atbalstītas straumēšanas atbildes.

Konfigurējot manuāli Windows sistēmā, ja atslēgu saišķis (keychain) ziņo par kļūdu, instalēšanas instrukcijās teikts atteikties no atslēgas saglabāšanas atslēgu saišķī un tā vietā izmantot vides mainīgo. Pēc tam palaidiet goose configure vēlreiz. Atslēgu saišķis ir neliela droša uzglabāšanas sistēma, ko operētājsistēma izmanto noslēpumu glabāšanai.

Konfigurācijas fails

Dokumentētās direktorijas ir:

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

Varat balstīt failu uz sniegto piemēru. Aizstājiet nosaukumu, adresi un modeļus ar savām vērtībām. Glabājiet atslēgu vides mainīgajā, ko norādījis api_key_env; nerakstiet īsto atslēgu 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
}

Saglabājiet skaitlisko vērtību context_limit, kā parādīts piemērā. Faktiskais konteksta ierobežojums ir atkarīgs no modeļa un OmniProxy; neuztveriet piemēra skaitli kā modeļa oficiālo ierobežojumu. Pirms tā izmantošanas palaidiet:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Pēc darba direktorijas ievadīšanas palaidiet:

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

Aizstājiet vērtību --model ar pilnu ID no saraksta. goose session nav start apakškomandas. Varat arī iestatīt --provider un --model izmantojot GOOSE_PROVIDER un GOOSE_MODEL vides mainīgos. Pat ja vārteja nevalidē atslēgas, OMNIPROXY_API_KEY joprojām ir jābūt vērtībai. Tā var būt viettura virkne, ko izmanto tikai jūsu vietējā datorā. Šī konfigurācija veiksmīgi nolasīja failu testēšanā 2026-10-09.

Logs

Settings

Settings sānjoslā
Models lapa
Add Custom Provider

Terminālis

goose configure

Atlasiet Custom Providers
Pēc tam atlasiet add
Kā tipu izvēlieties OpenAI Compatible

Fails

custom_providers

macOS un Linux tas atrodas zem ~/.config
Windows tas atrodas zem APPDATA
Iestatiet base_url saskaņā ar oficiālo piemēru

Visas trīs metodes izveido viena veida konfigurāciju. Kā pakalpojumu sniedzēja tipu atlasiet OpenAI Compatible.

Verifikācija ar reālu uzdevumu

Atveriet direktoriju, kurā ir parasts fails, un palaidiet goose session kā parādīts iepriekšējā sadaļā. Palūdziet tam nolasīt norādītā faila pirmo rindiņu. Tam vajadzētu atgriezt faila saturu, nevis tikai paziņot, ka konfigurācija ir saglabāta.

Lai lasītu failus vai izpildītu komandas, sesijai ir nepieciešams Developer paplašinājums. Developer paplašinājums ir rīka modulis, kas ļauj goose strādāt ar vietējiem failiem un komandām. Tas parasti ir iekļauts noklusējuma konfigurācijā. Ja goose saka, ka tai nav failu rīku, pievienojiet komandai šādu informāciju:

--with-builtin developer

Nepievienojiet arī --no-profile, jo šī opcija atspējo noklusējuma paplašinājumus.

Testēšanā 2026-10-09 goose 1.54.0 veiksmīgi nolasīja norādītā faila pirmo rindiņu. Pirmā atbilde var aizņemt aptuveni vienu minūti.

Pēc tam pārbaudiet OmniProxy pieprasījumu žurnālus, lai apstiprinātu avotu un modeļa nosaukumu.

Palaišana

Sesija atveras

goose session
Pakalpojumu sniedzējs ir tikko pievienotais
Modeļa nosaukums ir sarakstā

Uzdevums

Tas faktiski pabeidza uzdevumu

Piemēram, uzskaitiet pašreizējo direktoriju
Pārskatiet tā atbildi
Nepaļaujieties tikai uz veiksmīgu saglabāšanu

Žurnāli

Redzams vārtejā

Izmantojiet adresi no dokumentācijas piemēra
Nelieciet atslēgu repozitorijā
Modeļa ID atbilst sarakstam

Pēc pakalpojumu sniedzēja saglabāšanas apstipriniet to ar reālu sesiju.

Biežākās kļūdas

goose komandu nevar atrast: Pievienojiet instalēšanas direktoriju PATH, kā aprakstīts instalēšanas lapā, pēc tam atkārtoti atveriet termināli.
Darbvirsmas versijā M3 Mac datorā neparādās logs: Pārbaudiet lasīšanas un rakstīšanas atļaujas ~/.config.
Atslēgu saišķis neizdodas: Nesaglabājiet atslēgu atslēgu saišķī; tā vietā izmantojiet vides mainīgo.
Modelis nav sarakstā: Darbvirsmas versijā atlasiet Use custom model un manuāli ievadiet modeļa nosaukumu. goose configure nevar pieņemt pielāgotu modeļa nosaukumu. Termināļa lietošanai pārslēdzieties uz darbvirsmas versiju vai rediģējiet GOOSE_MODEL tieši konfigurācijā.
Adresi nevar sasniegt: Apstipriniet, ka API URL beidzas ar /v1/chat/completions, kā piemērā, un ka OmniProxy darbojas.
Tas saka, ka nevar nolasīt failus: Pievienojiet Developer paplašinājumu un neizmantojiet --no-profile.
Tas atgriež unsupported Responses role: system: Adrese parasti ir pareiza. Pārslēdzieties uz citu pilnu ID no modeļu saraksta.

Oficiālās atsauces

Instalēšanai skatiet Install goose. Pielāgotiem pakalpojumu sniedzējiem skatiet goose providers. Modeļu ID, kas izmantoti piemēros, skatiet xAI models page un GPT-6 Luna.

Aizstājiet katru vietniekvērtību ar vērtībām no sava OmniProxy konfigurācijas. Nekad nepublicējiet patieso atslēgu.

Saglabāts rezultāts vai HTTP 200 pats par sevi nepierāda pilnu aģenta saderību. Pārbaudiet avotu un modeli OmniProxy zvanu ierakstā.

Oficiālie avoti · goose ↗