Pag-install ng goose at Pag-configure ng Custom Provider

Ang goose ay isang general-purpose AI assistant na tumatakbo sa iyong computer. Bukod sa coding, kaya nitong humawak ng research, pagsusulat, automation, at pag-oorganisa ng data. Maaari mo itong gamitin sa pamamagitan ng desktop app, terminal, o API, at ang desktop at terminal version ay nagbabahagi ng parehong model configuration. Angkop ito para sa mga paulit-ulit na coding task at maaari ring kumonekta sa GitHub, mga database, at mga file.

Bago ka magsimula

Ang goose ay nag-aalok ng dalawang opsyon sa pag-install: Desktop at CLI. Ang Desktop ay ang graphical version na may window, habang ang CLI ay ginagamit sa pamamagitan ng pagpasok ng mga command sa isang terminal. Pareho silang nagbabahagi ng parehong core configuration, kabilang ang Provider at model. Ang Provider ay ang connection configuration na nagsasabi sa goose kung aling model service ang gagamitin.

Gusto ng window

goose Desktop

• I-download ang zip sa macOS
• O gamitin ang brew cask
• Gamitin ang installer package sa Linux

Terminal lamang

goose CLI

• download_cli.sh
• O ang Homebrew CLI
• Pagkatapos ay patakbuhin ang goose session

Windows

Pumili muna ng environment

• Git Bash o MSYS2
• Maaari mo ring gamitin ang PowerShell
• Kung hindi mahanap ang command, idagdag ito sa PATH

Bago magsimula, ihanda ang model ID mula sa kasalukuyang listahan ng model. Ang model ID ay ang pangalang ginagamit ng model service para tukuyin ang isang partikular na model, at dapat mong kopyahin ang kumpletong ID kapag ginagamit ito.

Pag-install at paglulunsad sa unang pagkakataon

Kung gusto mo ng graphical window

May dalawang dokumentadong paraan ng pag-install para sa macOS:

• I-download ito mula sa pahina ng pag-install. Ang pahina ay nagbibigay ng mga bersyon para sa macOS Silicon at macOS Intel. Pagkatapos mag-download, i-extract ang zip file at patakbuhin ang application sa loob.
• Bilang alternatibo, gamitin ang Homebrew:

brew install --cask block-goose

Ito ay nag-da-download ng parehong application at maaari ring humawak ng mga update.

Kung gumagamit ka ng Apple Mac M3 at walang window na lumalabas pagkatapos buksan ang app, suriin kung ang ~/.config ay nababasa at nasusulatan. Ginagamit ng goose ang directory na ito para magsulat ng mga log.

Para sa Linux desktop version, i-download ito mula sa pahina ng pag-install. Ang mga available na package ay DEB para sa Ubuntu/Debian, RPM para sa RHEL/Fedora, at Flatpak. Sa Debian o Ubuntu, i-download ang DEB file, buksan ang directory kung saan ito na-save, patakbuhin ang sudo dpkg -i (filename).deb, at pagkatapos ay buksan ang goose mula sa application menu. Palitan ang (filename) ng aktwal na pangalan ng file.

Para sa Windows desktop version, i-download ito mula sa pahina ng pag-install, i-extract ang zip file, at patakbuhin ang application sa loob.

Kung gusto mo lang ng terminal version

Sa macOS at Linux, patakbuhin ang:

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

Para laktawan ang interactive configuration sa panahon ng pag-install, idagdag ang CONFIGURE=false bago ang bash:

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

Sa macOS, maaari mo ring patakbuhin ang:

brew install block-goose-cli

Para i-update ang isang naka-install na CLI, patakbuhin ang:

goose update

Sa Windows, kailangan ang isa sa sumusunod na tatlong environment: Git Bash, na kasama sa Git para sa Windows at minarkahan bilang inirerekomenda; MSYS2; o PowerShell na kasama sa Windows 10/11. Sa Git Bash at MSYS2, gamitin ang parehong download_cli.sh command na ipinapakita sa itaas. Sa PowerShell, i-download muna ang script at pagkatapos ay patakbuhin ito:

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

Kung sinabihan ka na ang goose ay wala sa PATH, sundin ang pahina ng pag-install at idagdag ang ~/.local/bin o %USERPROFILE%\.local\bin sa kasalukuyang shell configuration, pagkatapos ay buksan muli ang terminal. Ang PATH ay isang set ng mga directory na hinahanap ng terminal para sa mga program. Kung ang installation directory ay hindi kasama, maaaring hindi mo mapatakbo ang isang naka-install na program sa pamamagitan ng direktang pagpasok ng pangalan nito.

Noong 2026-10-09, ang CLI version ay 1.54.0. Bilang default, inilalagay ng installation script ang program sa ~/.local/bin. Maaari mong baguhin ang directory na ito gamit ang GOOSE_BIN_DIR environment variable. Kung babaguhin mo ito, hindi awtomatikong ia-update ng script ang shell configuration, at mag-uulat ang terminal na ang directory ay wala sa PATH. Idagdag ang directory na iyon sa PATH o patakbuhin ang goose gamit ang buong path nito.

Sa unang pagkakataon na gagamitin mo ang goose, tatanungin ka nito na mag-configure ng isang Provider. Maaari mong laktawan ang mga built-in provider at magdagdag ng custom Provider gaya ng inilarawan sa susunod na seksyon. Sa terminal, mag-navigate sa directory kung saan mo gustong magtrabaho at patakbuhin ang:

goose session

Kunin ang mga connection value mula sa OmniProxy

Ihanda ang address, key, at pangalan ng model mula sa sarili mong OmniProxy instance. Ang halimbawa ng custom Provider ay gumagamit ng base_url na nagtatapos sa /v1/chat/completions, kaya ang gabay na ito ay sumusunod sa parehong format:

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

Kopyahin ang kumpletong pangalan ng model mula sa kasalukuyang listahan ng OmniProxy, kasama ang anumang slash. Noong 2026-10-09, ang dalawang reference ID sa dokumentasyon ng provider ay grok-4.7 para sa Grok at gpt-6-luna mula sa dokumentasyon ng OpenAI. gpt-6-luna sumusuporta sa Chat Completions; ang function calling sa Chat Completions ay suportado lamang kapag ang reasoning_effort ay naka-set sa none. Huwag kopyahin ang isang pangalan na hindi lumalabas sa listahan.

Ipasok ang configuration ng tool

Ang isang custom Provider ay maaaring gumamit ng format na compatible sa OpenAI, Anthropic, o Ollama. Ang compatible format ay nangangahulugan na ang tool ay nagpapadala ng mga request ayon sa isang karaniwang API specification. Kapag kumokonekta sa OmniProxy, piliin ang OpenAI Compatible.

Desktop

1. I-click ang button sa upper-left corner para buksan ang sidebar.
2. I-click ang Settings.
3. I-click ang Models.
4. I-click ang Configure providers.
5. I-click ang Add Custom Provider sa ibaba ng window.
6. Para sa Provider Type, piliin ang OpenAI Compatible. Maaari mong i-set ang Display Name sa OmniProxy. Ipasok ang address mula sa nakaraang seksyon sa API URL. Kung kailangan ng key, piliin ang opsyon na nangangailangan ng API Key at ipasok ang iyong OmniProxy key. Sa Available Models, ipasok ang mga pangalan ng model, na pinaghihiwalay ang maraming pangalan ng kuwit.
7. I-click ang Create Provider.

Ang desktop version ay kasalukuyang hindi makapag-define ng mga custom request header sa window na ito. Kung kailangan mo ng mga request header, i-edit ang configuration file pagkatapos gawin ang Provider.

Terminal

Patakbuhin ang:

goose configure

Piliin ang Custom Providers, pagkatapos ay piliin ang Add A Custom Provider. Para sa API Type, piliin ang OpenAI Compatible, pagkatapos ay sundin ang mga prompt para ipasok ang pangalan, API URL, kung kailangan ng key, mga pangalan ng model, at kung suportado ang streaming response.

Kapag nag-co-configure nang manu-mano sa Windows, kung ang keychain ay nag-uulat ng error, sinasabi ng mga tagubilin sa pag-install na tanggihan ang pag-save ng key sa keyring at gumamit na lamang ng environment variable. Pagkatapos ay patakbuhin ang goose configure muli. Ang keychain ay isang maliit na secure storage system na ginagamit ng operating system para i-store ang mga sikreto.

Configuration file

Ang mga dokumentadong directory ay:

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

Maaari mong ibase ang file sa ibinigay na halimbawa. Palitan ang pangalan, address, at mga model ng sarili mong mga value. I-store ang key sa environment variable na tinukoy ng api_key_env; huwag isulat ang totoong key sa file:

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

Panatilihin ang numeric value para sa context_limit, gaya ng ipinapakita sa halimbawa. Ang aktwal na limitasyon ng context ay nakadepende sa model at OmniProxy; huwag ituring ang halimbawang numero bilang opisyal na limitasyon ng model. Bago ito gamitin, patakbuhin ang:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Pagkatapos pumasok sa working directory, patakbuhin ang:

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

Palitan ang value ng --model ng kumpletong ID mula sa listahan. goose session ay walang start subcommand. Maaari mo ring i-set ang --provider at --model sa pamamagitan ng GOOSE_PROVIDER at GOOSE_MODEL environment variables. Kahit hindi bina-validate ng gateway ang mga key, OMNIPROXY_API_KEY ay dapat pa ring magkaroon ng value. Maaari itong maging isang placeholder string na ginagamit lamang sa iyong lokal na computer. Ang configuration na ito ay matagumpay na nakabasa ng file sa testing noong 2026-10-09.

Window

Settings

• Settings sa sidebar
• Models page
• Add Custom Provider

Terminal

goose configure

• Piliin ang Custom Providers
• Pagkatapos ay piliin ang add
• Piliin ang OpenAI Compatible bilang uri

File

custom_providers

• Sa macOS at Linux, ito ay nasa ilalim ng ~/.config
• Sa Windows, ito ay nasa ilalim ng APPDATA
• I-set ang base_url ayon sa opisyal na halimbawa

I-verify gamit ang totoong gawain

Buksan ang isang directory na naglalaman ng regular na file at patakbuhin ang goose session gaya ng ipinapakita sa nakaraang seksyon. Utusan itong basahin ang unang linya ng isang file na tinukoy mo. Dapat itong magbalik ng nilalaman ng file sa halip na sabihin lamang na na-save ang configuration.

Para magbasa ng mga file o mag-execute ng mga command, kailangan ng session ang Developer extension. Ang Developer extension ay isang tool module na nagpapahintulot sa goose na magtrabaho kasama ang mga lokal na file at command. Karaniwan itong kasama sa default configuration. Kung sinabi ng goose na wala itong mga file tool, idagdag ang sumusunod sa command:

--with-builtin developer

Huwag ding idagdag ang --no-profile, dahil ang opsyon na iyon ay nagdi-disable ng mga default extension.

Sa testing noong 2026-10-09, matagumpay na nabasa ng goose 1.54.0 ang unang linya ng tinukoy na file. Ang unang response ay maaaring tumagal ng humigit-kumulang isang minuto.

Pagkatapos ay suriin ang OmniProxy request logs para kumpirmahin ang source at pangalan ng model.

Ilunsad

Nagbubukas ang isang session

• goose session
• Ang Provider ay ang idinagdag lang
• Ang pangalan ng model ay nasa listahan

Gawain

Aktwal nitong nakumpleto ang gawain

• Halimbawa, ilista ang kasalukuyang directory
• Suriin ang response nito
• Huwag umasa lamang sa matagumpay na pag-save

Logs

Makikita sa gateway

• Gamitin ang address mula sa halimbawa sa dokumentasyon
• Huwag ilagay ang key sa repository
• Ang model ID ay tumutugma sa listahan

Mga karaniwang error

• Ang goose command ay hindi mahanap: Idagdag ang installation directory sa PATH gaya ng inilarawan sa pahina ng pag-install, pagkatapos ay buksan muli ang terminal.
• Walang window na lumalabas sa desktop version sa isang M3 Mac: Suriin ang mga read at write permission para sa ~/.config.
• Nabigo ang keychain: Huwag i-save ang key sa keyring; gumamit na lamang ng environment variable.
• Ang model ay wala sa listahan: Sa desktop version, piliin ang Use custom model at ipasok ang pangalan ng model nang manu-mano. goose configure ay hindi makatanggap ng custom model name. Para sa paggamit sa terminal, lumipat sa desktop version o i-edit ang GOOSE_MODEL nang direkta sa configuration.
• Hindi maabot ang address: Kumpirmahin na ang API URL ay nagtatapos sa /v1/chat/completions, gaya ng sa halimbawa, at na tumatakbo ang OmniProxy.
• Sinasabi nito na hindi ito makabasa ng mga file: Idagdag ang Developer extension at huwag gamitin ang --no-profile.
• Nagbabalik ito ng unsupported Responses role: system: Ang address ay karaniwang tama. Lumipat sa isa pang kumpletong ID mula sa listahan ng model.

Mga opisyal na sanggunian

Para sa pag-install, tingnan ang Install goose. Para sa mga custom Provider, tingnan ang goose providers. Para sa mga model ID na ginamit sa mga halimbawa, tingnan ang xAI models page at GPT-6 Luna.

Palagyan ng halaga mula sa iyong sariling konfigurasyon ng OmniProxy ang bawat placeholder. Huwag kailanman ilabas ang tunay na key.

Ang isang na-save na resulta o HTTP 200 lamang ay hindi patunay ng full Agent compatibility. Suriin ang source at modelo sa call log ng OmniProxy.

Mga opisyal na pinagkukunan · goose ↗