Kusakinisha goose na Kusanidi Mtoa Huduma Maalum

goose ni msaidizi wa AI wa madhumuni ya jumla anayefanya kazi kwenye kompyuta yako. Mbali na kuandika msimbo, inaweza kushughulikia utafiti, uandishi, otomatiki, na upangaji wa data. Unaweza kuitumia kupitia programu ya mezani, terminal, au API, na matoleo ya mezani na ya terminal yanashiriki usanidi sawa wa modeli. Inafaa kwa kazi za kurudia za kuandika msimbo na inaweza pia kuunganishwa na GitHub, hifadhidata, na faili.

Kabla hujaanza

goose hutoa chaguzi mbili za usakinishaji: Desktop na CLI. Desktop ni toleo la picha lenye dirisha, wakati CLI hutumiwa kwa kuingiza amri kwenye terminal. Zote mbili zinashiriki usanidi sawa wa msingi, ikijumuisha Mtoa Huduma na modeli. Mtoa Huduma ni usanidi wa muunganisho unaoiambia goose ni huduma gani ya modeli ya kutumia.

Unataka dirisha

goose Desktop

• Pakua zip kwenye macOS
• Au tumia brew cask
• Tumia kifurushi cha kisakinishi kwenye Linux

Terminal pekee

goose CLI

• download_cli.sh
• Au Homebrew CLI
• Kisha tekeleza goose session

Windows

Chagua mazingira kwanza

• Git Bash au MSYS2
• Unaweza pia kutumia PowerShell
• Ikiwa amri haipatikani, iongeze kwenye PATH

Kabla ya kuanza, uwe na kitambulisho cha modeli kutoka kwenye orodha ya sasa ya modeli tayari. Kitambulisho cha modeli ni jina ambalo huduma ya modeli hutumia kutambua modeli mahususi, na lazima ukopi kitambulisho kamili unapoitumia.

Sakinisha na uzindue kwa mara ya kwanza

Ikiwa unataka dirisha la picha

Kuna njia mbili za usakinishaji zilizoorodheshwa kwa macOS:

• Ipakue kutoka kwenye ukurasa wa usakinishaji. Ukurasa hutoa matoleo ya macOS Silicon na macOS Intel. Baada ya kupakua, toa faili ya zip na uendeshe programu iliyo ndani.
• Vinginevyo, tumia Homebrew:

brew install --cask block-goose

Hii hupakua programu hiyo hiyo na inaweza pia kushughulikia sasisho.

Ikiwa unatumia Apple Mac M3 na hakuna dirisha linaloonekana baada ya kufungua programu, angalia ikiwa ~/.config inaweza kusomeka na kuandikika. goose hutumia saraka hii kuandika kumbukumbu.

Kwa toleo la mezani la Linux, ipakue kutoka kwenye ukurasa wa usakinishaji. Vifurushi vinavyopatikana ni DEB kwa Ubuntu/Debian, RPM kwa RHEL/Fedora, na Flatpak. Kwenye Debian au Ubuntu, pakua faili ya DEB, fungua saraka ambapo ilihifadhiwa, tekeleza sudo dpkg -i (filename).deb, kisha ufungue goose kutoka kwenye menyu ya programu. Badilisha (filename) na jina halisi la faili.

Kwa toleo la mezani la Windows, ipakue kutoka kwenye ukurasa wa usakinishaji, toa faili ya zip, na uendeshe programu iliyo ndani.

Ikiwa unataka toleo la terminal pekee

Kwenye macOS na Linux, tekeleza:

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

Ili kuruka usanidi wa mwingiliano wakati wa usakinishaji, ongeza CONFIGURE=false kabla ya bash:

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

Kwenye macOS, unaweza pia kutekeleza:

brew install block-goose-cli

Ili kusasisha CLI iliyosakinishwa, tekeleza:

goose update

Kwenye Windows, moja ya mazingira matatu yafuatayo inahitajika: Git Bash, ambayo imejumuishwa na Git kwa Windows na kuwekwa alama kama inayopendekezwa; MSYS2; au PowerShell iliyojumuishwa na Windows 10/11. Katika Git Bash na MSYS2, tumia amri hiyo hiyo ya download_cli.sh iliyoonyeshwa hapo juu. Katika PowerShell, pakua hati kwanza na kisha uitekeleze:

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

Ikiwa unaambiwa kuwa goose haiko kwenye PATH, fuata ukurasa wa usakinishaji na uongeze ~/.local/bin au %USERPROFILE%\.local\bin kwenye usanidi wa sasa wa shell, kisha ufungue upya terminal. PATH ni seti ya saraka ambazo terminal hutafuta programu. Ikiwa saraka ya usakinishaji haijajumuishwa, unaweza kushindwa kutekeleza programu iliyosakinishwa kwa kuingiza jina lake moja kwa moja.

Kufikia 2026-10-09, toleo la CLI lilikuwa 1.54.0. Kwa chaguo-msingi, hati ya usakinishaji huweka programu kwenye ~/.local/bin. Unaweza kubadilisha saraka hii na kigezo cha mazingira cha GOOSE_BIN_DIR. Ikiwa utaibadilisha, hati haitasasisha kiotomatiki usanidi wa shell, na terminal itaripoti kuwa saraka haiko kwenye PATH. Ongeza saraka hiyo kwenye PATH au tekeleza goose kwa kutumia njia yake kamili.

Mara ya kwanza unapotumia goose, itakuuliza usanidi Mtoa Huduma. Unaweza kuruka watoa huduma waliojengwa ndani na kuongeza Mtoa Huduma maalum kama ilivyoelezwa katika sehemu inayofuata. Kwenye terminal, nenda kwenye saraka ambapo unataka kufanya kazi na utekeleze:

goose session

Pata thamani za muunganisho kutoka OmniProxy

Andaa anwani, ufunguo, na jina la modeli kutoka kwa mfano wako mwenyewe wa OmniProxy. Mfano wa Mtoa Huduma maalum hutumia base_url inayoishia na /v1/chat/completions, kwa hivyo mwongozo huu unafuata umbizo sawa:

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

Nakili jina kamili la modeli kutoka kwenye orodha ya sasa ya OmniProxy, ikijumuisha mikwaju yoyote. Kufikia 2026-10-09, vitambulisho viwili vya marejeleo katika hati za mtoa huduma vilikuwa grok-4.7 kwa Grok na gpt-6-luna kutoka kwa hati za OpenAI. gpt-6-luna inasaidia Chat Completions; utekelezaji wa kazi katika Chat Completions unasaidiwa tu wakati reasoning_effort imewekwa kuwa none. Usikopi jina ambalo halionekani kwenye orodha.

Ingiza usanidi wa zana

Mtoa Huduma maalum anaweza kutumia umbizo linalooana na OpenAI, Anthropic, au Ollama. Umbizo linalooana linamaanisha kuwa zana hutuma maombi kulingana na vipimo vya kawaida vya API. Unapounganisha na OmniProxy, chagua OpenAI Compatible.

Desktop

1. Bofya kitufe kwenye kona ya juu kushoto ili kufungua upau wa pembeni.
2. Bofya Settings.
3. Bofya Models.
4. Bofya Configure providers.
5. Bofya Add Custom Provider chini ya dirisha.
6. Kwa Aina ya Mtoa Huduma, chagua OpenAI Compatible. Unaweza kuweka Jina la Kuonyesha kuwa OmniProxy. Ingiza anwani kutoka sehemu iliyotangulia kwenye API URL. Ikiwa ufunguo unahitajika, chagua chaguo linalohitaji API Key na uingize ufunguo wako wa OmniProxy. Katika Modeli Zinazopatikana, ingiza majina ya modeli, ukitenganisha majina mengi na koma.
7. Bofya Create Provider.

Toleo la mezani kwa sasa haliwezi kufafanua vichwa vya ombi maalum kwenye dirisha hili. Ikiwa unahitaji vichwa vya ombi, hariri faili ya usanidi baada ya kuunda Mtoa Huduma.

Terminal

Tekeleza:

goose configure

Chagua Custom Providers, kisha chagua Add A Custom Provider. Kwa Aina ya API, chagua OpenAI Compatible, kisha fuata maagizo ya kuingiza jina, API URL, ikiwa ufunguo unahitajika, majina ya modeli, na ikiwa majibu ya utiririshaji yanasaidiwa.

Unaposanidi mwenyewe kwenye Windows, ikiwa keychain inaripoti hitilafu, maagizo ya usakinishaji yanasema kukataa kuhifadhi ufunguo kwenye keyring na kutumia kigezo cha mazingira badala yake. Kisha tekeleza goose configure tena. Keychain ni mfumo mdogo wa kuhifadhi salama unaotumiwa na mfumo wa uendeshaji kuhifadhi siri.

Faili ya usanidi

Saraka zilizoorodheshwa ni:

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

Unaweza kuweka faili kulingana na mfano uliotolewa. Badilisha jina, anwani, na modeli na thamani zako mwenyewe. Hifadhi ufunguo kwenye kigezo cha mazingira kilichobainishwa na api_key_env; usiandike ufunguo halisi kwenye 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
}

Weka thamani ya nambari kwa context_limit, kama inavyoonyeshwa kwenye mfano. Kikomo halisi cha muktadha kinategemea modeli na OmniProxy; usichukulie nambari ya mfano kama kikomo rasmi cha modeli. Kabla ya kuitumia, tekeleza:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Baada ya kuingia kwenye saraka ya kazi, tekeleza:

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

Badilisha thamani ya --model na kitambulisho kamili kutoka kwenye orodha. goose session haina amri ndogo ya start. Unaweza pia kuweka --provider na --model kupitia vigezo vya mazingira vya GOOSE_PROVIDER na GOOSE_MODEL. Hata kama lango halithibitishi funguo, OMNIPROXY_API_KEY lazima bado iwe na thamani. Inaweza kuwa kamba ya kishika nafasi inayotumiwa kwenye kompyuta yako ya ndani pekee. Usanidi huu ulisoma faili kwa mafanikio katika majaribio tarehe 2026-10-09.

Dirisha

Settings

• Settings kwenye upau wa pembeni
• Ukurasa wa Models
• Add Custom Provider

Terminal

goose configure

• Chagua Custom Providers
• Kisha chagua add
• Chagua OpenAI Compatible kama aina

Faili

custom_providers

• Kwenye macOS na Linux, iko chini ya ~/.config
• Kwenye Windows, iko chini ya APPDATA
• Weka base_url kulingana na mfano rasmi

Thibitisha na kazi halisi

Fungua saraka iliyo na faili ya kawaida na utekeleze goose session kama inavyoonyeshwa katika sehemu iliyotangulia. Iombe isome mstari wa kwanza wa faili unayobainisha. Inapaswa kurudisha maudhui ya faili badala ya kusema tu kuwa usanidi umehifadhiwa.

Ili kusoma faili au kutekeleza amri, kipindi kinahitaji kiendelezi cha Developer. Kiendelezi cha Developer ni moduli ya zana inayoruhusu goose kufanya kazi na faili za ndani na amri. Kwa kawaida hujumuishwa katika usanidi wa chaguo-msingi. Ikiwa goose inasema kuwa haina zana za faili, ongeza yafuatayo kwenye amri:

--with-builtin developer

Usiongeze pia --no-profile, kwa sababu chaguo hilo huzima viendelezi vya chaguo-msingi.

Katika majaribio tarehe 2026-10-09, goose 1.54.0 ilisoma kwa mafanikio mstari wa kwanza wa faili iliyobainishwa. Jibu la kwanza linaweza kuchukua takriban dakika moja.

Kisha angalia kumbukumbu za ombi za OmniProxy ili kuthibitisha chanzo na jina la modeli.

Zindua

Kipindi kinafunguka

• goose session
• Mtoa Huduma ndiye aliyeongezwa tu
• Jina la modeli liko kwenye orodha

Kazi

Ilikamilisha kazi kweli

• Kwa mfano, orodhesha saraka ya sasa
• Kagua jibu lake
• Usitegemee tu uhifadhi wa mafanikio

Kumbukumbu

Inaonekana kwenye lango

• Tumia anwani kutoka kwa mfano wa hati
• Usiweke ufunguo kwenye hazina
• Kitambulisho cha modeli kinalingana na orodha

Hitilafu za kawaida

• Amri ya goose haiwezi kupatikana: Ongeza saraka ya usakinishaji kwenye PATH kama ilivyoelezwa kwenye ukurasa wa usakinishaji, kisha ufungue upya terminal.
• Hakuna dirisha linaloonekana kwenye toleo la mezani kwenye M3 Mac: Angalia ruhusa za kusoma na kuandika kwa ~/.config.
• Keychain inashindwa: Usihifadhi ufunguo kwenye keyring; tumia kigezo cha mazingira badala yake.
• Modeli haiko kwenye orodha: Kwenye toleo la mezani, chagua Use custom model na uingize jina la modeli mwenyewe. goose configure haiwezi kukubali jina la modeli maalum. Kwa matumizi ya terminal, badilisha hadi toleo la mezani au hariri GOOSE_MODEL moja kwa moja kwenye usanidi.
• Anwani haiwezi kufikiwa: Thibitisha kuwa API URL inaishia na /v1/chat/completions, kama ilivyo kwenye mfano, na kwamba OmniProxy inafanya kazi.
• Inasema haiwezi kusoma faili: Ongeza kiendelezi cha Developer na usitumie --no-profile.
• Inarudisha unsupported Responses role: system: Anwani kwa kawaida ni sahihi. Badilisha hadi kitambulisho kingine kamili kutoka kwenye orodha ya modeli.

Marejeleo rasmi

Kwa usakinishaji, angalia Sakinisha goose. Kwa Watoa Huduma maalum, angalia watoa huduma wa goose. Kwa vitambulisho vya modeli vinavyotumiwa kwenye mifano, angalia ukurasa wa modeli za xAI na GPT-6 Luna.

Badilisha kila nafasi yenye thamani kutoka kwenye usanidi wako wa OmniProxy. Usitangaze funguo halisi.

Matokeo yaliyohifadhiwa au HTTP 200 pekee hayathibitishi utangamano kamili wa Agent. Angalia chanzo na mfano katika rekodi ya maombi ya OmniProxy.

Vyanzo rasmi · goose ↗