Installazzjoni ta’ goose u konfigurazzjoni ta’ Provider personalizzat

goose huwa assistent tal-AI għal użu ġenerali li jaħdem fuq il-kompjuter tiegħek. Minbarra l-kodiċi, jista’ jagħmel tiftix, kitba, awtomazzjoni u organizzazzjoni tad-data. Tista’ tużah permezz tal-verżjoni Desktop, it-terminal jew interfaċċa, u l-verżjonijiet Desktop u tat-terminal jużaw l-istess konfigurazzjoni tal-mudelli. Huwa adattat għal xogħol ripetittiv ta’ programmazzjoni u jista’ wkoll jikkonnettja ma’ GitHub, databases u fajls.

Tħejjija qabel l-installazzjoni

goose joffri żewġ metodi ta’ installazzjoni: Desktop u CLI. Desktop hija l-verżjoni b’tieqa grafika, filwaqt li CLI hija l-verżjoni li tuża billi ddaħħal kmandi fit-terminal. It-tnejn jużaw l-istess konfigurazzjoni ewlenija, inklużi l-Provider u l-mudell. Provider jista’ jitqies bħala l-konfigurazzjoni tal-konnessjoni li tgħid lil goose liema servizz tal-mudell għandu juża.

Trid tieqa

goose Desktop

Niżżel iż-zip għal macOS
Jew uża brew cask
Fuq Linux uża l-pakkett tal-installazzjoni

Terminal biss

goose CLI

download_cli.sh
Jew Homebrew CLI
Imbagħad goose session

Windows

L-ewwel agħżel l-ambjent

Git Bash jew MSYS2
Tista' tuża wkoll PowerShell
Żid ma' PATH jekk il-kmand ma jinstabx

Fuq macOS tista’ tuża tniżżil jew Homebrew. Għall-verżjoni Desktop fuq Linux, uża l-pakkett tad-distribuzzjoni. Fuq Windows, l-ewwel iċċekkja l-ambjenti tat-terminal speċifikati.

Qabel tibda, ħejji l-ID tal-mudell mil-lista attwali tal-mudelli. L-ID tal-mudell huwa l-isem li s-servizz juża biex jidentifika mudell speċifiku, u meta tużah trid tikkopjah kollu.

Installazzjoni u l-ewwel tnedija

Jekk trid tieqa grafika

Għal macOS hemm żewġ metodi ta’ installazzjoni:

Niżżel mill-paġna tal-installazzjoni. Il-paġna tinkludi macOS Silicon u macOS Intel. Wara t-tniżżil, ħoll il-fajl zip u ħaddem il-programm li hemm fih.
Jew uża Homebrew:

brew install --cask block-goose

Dan iniżżel l-istess applikazzjoni u jista’ jieħu ħsieb ukoll l-aġġornamenti.

Jekk qed tuża Apple Mac M3 u ma tidher l-ebda tieqa wara li tiftaħ l-applikazzjoni, iċċekkja jekk ~/.config jistax jinqara u jinkiteb. goose juża dan id-direttorju biex jikteb il-logs.

Għall-verżjoni Desktop fuq Linux, niżżel mill-paġna tal-installazzjoni. Hemm pakketti DEB (Ubuntu/Debian), RPM (RHEL/Fedora) u Flatpak. Għal Debian jew Ubuntu: niżżel id-DEB, mur fid-direttorju fejn ġie ssejvjat, ħaddem sudo dpkg -i (filename).deb, u mbagħad iftaħ goose mill-menu tal-applikazzjonijiet. Ibdel (filename) bl-isem reali tal-fajl.

Għall-verżjoni Desktop fuq Windows, niżżel mill-paġna tal-installazzjoni, ħoll il-fajl zip u ħaddem il-programm li hemm fih.

Jekk trid it-terminal biss

Fuq macOS u Linux ħaddem:

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

Jekk ma tridx tagħmel konfigurazzjoni interattiva waqt l-installazzjoni, żid CONFIGURE=false fil-bidu:

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

Fuq macOS tista’ wkoll tħaddem:

brew install block-goose-cli

Biex taġġorna CLI diġà installat, uża:

goose update

Fuq Windows huwa meħtieġ wieħed minn dawn it-tliet ambjenti: Git Bash (ipprovdut ma’ Git for Windows u mmarkat bħala rrakkomandat), MSYS2, jew PowerShell inkluż ma’ Windows 10/11. Għal Git Bash u MSYS2, uża l-istess kmand download_cli.sh ta’ hawn fuq. Għal PowerShell, l-ewwel niżżel l-iskript u mbagħad ħaddmu:

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

Jekk jidher messaġġ li goose mhuwiex fil-PATH, segwi l-paġna tal-installazzjoni biex iżżid ~/.local/bin jew %USERPROFILE%\.local\bin mal-konfigurazzjoni tas-shell attwali, u mbagħad iftaħ it-terminal mill-ġdid. PATH huwa grupp ta’ direttorji li fihom it-terminal ifittex il-programmi. Jekk id-direttorju ma jkunx miżjud, jista’ ma jkunx possibbli li tħaddem programm installat billi ddaħħal ismu direttament.

Fl-2026-10-09, il-verżjoni ta’ CLI kienet 1.54.0. B’mod awtomatiku, l-iskript tal-installazzjoni jqiegħed il-programm f’~/.local/bin. Tista’ tbiddel dan id-direttorju bil-varjabbli tal-ambjent GOOSE_BIN_DIR. Wara li tibdlu, l-iskript ma jżidx awtomatikament id-direttorju mal-konfigurazzjoni tas-shell, u t-terminal javża li d-direttorju mhuwiex fil-PATH. Żid dak id-direttorju mal-PATH jew uża l-perkors sħiħ biex tħaddem il-programm.

Meta tużah għall-ewwel darba, goose jitolbok tikkonfigura Provider. Tista’ taqbeż il-fornituri integrati u żżid Provider personalizzat kif spjegat fit-taqsima li jmiss. Fit-terminal, mur fid-direttorju fejn trid taħdem u ħaddem:

goose session

Ikseb il-parametri tal-konnessjoni minn OmniProxy

Ħejji l-indirizz, iċ-ċavetta u l-isem tal-mudell mill-OmniProxy tiegħek. L-eżempju għal Provider personalizzat juża /v1/chat/completions f’base_url, għalhekk hawnhekk tintuża l-istess forma:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Ikkopja mil-lista attwali tal-mudelli ta’ OmniProxy; issepara mudelli multipli b’virgoli Ingliżi

Ikkopja l-isem sħiħ tal-mudell mil-lista attwali ta’ OmniProxy, inklużi kwalunkwe slashes. Fl-2026-10-09, iż-żewġ IDs ta’ referenza fid-dokumentazzjoni tal-fornituri kienu grok-4.7 għal Grok u gpt-6-luna fid-dokumentazzjoni ta’ OpenAI. gpt-6-luna jappoġġja Chat Completions; f’Chat Completions, is-sejħiet tal-funzjonijiet huma appoġġjati biss meta reasoning_effort ikun none. Tikkopjax ismijiet li mhumiex fil-lista.

Daħħal il-konfigurazzjoni tal-għodda

Provider personalizzat juża format kompatibbli ma’ OpenAI, Anthropic jew Ollama. Format kompatibbli jfisser li l-għodda tibgħat it-talbiet skont interfaċċa komuni partikolari. Meta tikkonnettja ma’ OmniProxy, agħżel OpenAI Compatible.

Verżjoni Desktop

Ikklikkja l-buttuna fin-naħa ta’ fuq fuq ix-xellug biex tiftaħ il-sidebar.
Ikklikkja Settings.
Ikklikkja Models.
Ikklikkja Configure providers.
Ikklikkja Add Custom Provider fil-qiegħ tat-tieqa.
Għal Provider Type agħżel OpenAI Compatible. F’Display Name tista’ ddaħħal OmniProxy. F’API URL daħħal l-indirizz mit-taqsima ta’ qabel. Jekk hija meħtieġa ċavetta, immarka l-għażla li teħtieġ API Key u daħħal iċ-ċavetta ta’ OmniProxy. F’Available Models daħħal l-ismijiet tal-mudelli, separati b’virgoli Ingliżi jekk hemm aktar minn wieħed.
Ikklikkja Create Provider.

Bħalissa, il-verżjoni Desktop ma tippermettix li tiddefinixxi headers personalizzati tat-talbiet f’din it-tieqa. Jekk teħtieġ headers, immodifika l-fajl tal-konfigurazzjoni wara li toħloq il-Provider.

Terminal

Ħaddem:

goose configure

Agħżel Custom Providers, imbagħad Add A Custom Provider. Għal API Type agħżel OpenAI Compatible, u wara segwi l-istruzzjonijiet biex iddaħħal l-isem, l-API URL, jekk hijiex meħtieġa ċavetta, l-isem tal-mudell u jekk humiex appoġġjati tweġibiet streaming.

Meta tagħmel konfigurazzjoni manwali fuq Windows, jekk iseħħ żball fil-keychain, agħżel li ma taħżinx iċ-ċavetta fil-keyring meta tintalab, u uża varjabbli tal-ambjent minflok. Imbagħad erġa’ ħaddem goose configure. Il-keychain huwa maħżen sigur żgħir li s-sistema tuża biex iżżomm iċ-ċwievet.

Fajl tal-konfigurazzjoni

Id-direttorji huma:

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

Tista’ tibbaża l-fajl fuq dan l-eżempju. Ibdel l-isem, l-indirizz u l-mudelli b’dawk tiegħek. Poġġi ċ-ċavetta fil-varjabbli tal-ambjent speċifikat minn api_key_env; tiktibx iċ-ċavetta reali fil-fajl:

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

Għal context_limit, żomm numru bħal fl-eżempju. Il-kuntest reali jiddependi mill-mudell u minn OmniProxy; tqisx in-numru fl-eżempju bħala l-limitu uffiċjali tal-mudell. Qabel tuża l-konfigurazzjoni, ħaddem:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Wara li tidħol fid-direttorju tax-xogħol:

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

Ibdel il-valur ta’ --model bl-ID sħiħ mil-lista. goose session m’għandux subkmand start. Tista’ wkoll tissettja --provider u --model permezz tal-varjabbli tal-ambjent GOOSE_PROVIDER u GOOSE_MODEL. Anki jekk il-gateway ma jivverifikax iċ-ċavetta, OMNIPROXY_API_KEY xorta jrid ikollu valur; dan jista’ jkun sekwenza ta’ karattri placeholder użata lokalment biss. Fl-2026-10-09, din il-konfigurazzjoni rnexxielha taqra l-fajl.

Tieqa

Settings

Settings fil-sidebar
Il-paġna Models
Add Custom Provider

Terminal

goose configure

Agħżel Custom Providers
Imbagħad agħżel li żżid wieħed
Agħżel OpenAI Compatible bħala t-tip

Fajl

custom_providers

Fuq macOS u Linux jinsab f'~/.config
Fuq Windows jinsab f'APPDATA
Issettja base_url skont l-eżempju uffiċjali

It-tliet metodi jiktbu l-istess tip ta’ konfigurazzjoni. Għat-tip ta’ Provider, agħżel OpenAI Compatible.

Ivverifika kompitu reali

Mur f’direttorju li fih fajl ordinarju u ħaddem goose session mit-taqsima ta’ qabel. Itolbu jaqra l-ewwel linja tal-fajl li tispeċifika. Għandu jagħti l-kontenut tal-fajl, mhux sempliċement juri li l-konfigurazzjoni ġiet issejvjata.

Biex jaqra fajls jew iħaddem kmandi, is-sessjoni teħtieġ l-estensjoni Developer. L-estensjoni Developer tista’ titqies bħala modulu ta’ għodod li jippermetti lil goose jaħdem ma’ fajls u kmandi lokali. Il-konfigurazzjoni predefinita normalment tinkludiha. Jekk iwieġeb li m’għandux għodod għall-fajls, żid dan mal-kmand:

--with-builtin developer

Iżżidx ukoll --no-profile, għax dak il-parametru jitfi l-estensjonijiet predefiniti.

Fl-2026-10-09, goose 1.54.0 qara l-ewwel linja tal-fajl speċifikat. L-ewwel tweġiba tista’ tieħu madwar minuta.

Imbagħad iċċekkja s-sors u l-isem tal-mudell fir-rekords tas-sejħiet ta’ OmniProxy.

Tnedija

Tista' tidħol f'sessjoni

goose session
Il-Provider huwa dak li għadek kif żidt
L-isem tal-mudell jinsab fil-lista

Kompitu

Tabilħaqq wettaq il-kompitu

Pereżempju, elenka d-direttorju attwali
Ara t-tweġiba tiegħu
Tibbażax biss fuq il-konferma li ġie ssejvjat

Reġistru

Jidher fil-gateway

Uża l-indirizz mill-eżempju tad-dokumentazzjoni
Tiktibx iċ-ċavetta fir-repożitorju
L-ID tal-mudell jaqbel mal-lista

Wara li tissejvja l-Provider, xorta trid tivverifikah b’sessjoni reali.

Żbalji komuni

Il-kmand goose ma jinstabx: segwi l-paġna tal-installazzjoni biex iżżid id-direttorju tal-installazzjoni mal-PATH, u mbagħad iftaħ it-terminal mill-ġdid.
Ma tidher l-ebda tieqa fil-verżjoni Desktop fuq M3: iċċekkja l-permessi tal-qari u l-kitba ta’ ~/.config.
Il-keychain tfalli: taħżinx iċ-ċavetta fil-keyring; uża varjabbli tal-ambjent minflok.
Il-mudell mhuwiex fil-lista: fil-verżjoni Desktop tista’ tagħżel Use custom model u ddaħħal l-isem tal-mudell manwalment. goose configure ma jippermettix li ddaħħal isem personalizzat ta’ mudell; għat-terminal, uża l-verżjoni Desktop minflok jew immodifika direttament GOOSE_MODEL fil-konfigurazzjoni.
Ma jistax jikkonnettja mal-indirizz: ivverifika li l-API URL jispiċċa b’/v1/chat/completions bħal fl-eżempju, u li OmniProxy qed jaħdem.
Jgħid li ma jistax jaqra l-fajl: żid l-estensjoni Developer u tużax --no-profile.
Jirritorna unsupported Responses role: system: normalment l-indirizz ikun korrett. Uża ID sħiħ ieħor mil-lista tal-mudelli.

Referenzi uffiċjali

Għall-installazzjoni, ara Install goose. Għal Provider personalizzat, ara goose providers. Għall-IDs tal-mudelli użati fl-eżempji, ara il-paġna tal-mudelli ta’ xAI u GPT-6 Luna.

Ibdel kull placeholder b'valuri mill-konfigurazzjoni personali tiegħek ta' OmniProxy. Qatt ma npubblika key reali.

Risultat salvat jew HTTP 200 waħdu ma jipprovax kompatibilità sħiħa tal-Agent. Iċċekkja s-sors u l-mudell fir-rekord tat-talba ta' OmniProxy.

Sorsi uffiċjali · goose ↗