Инсталација goose-а и конфигурација прилагођеног провајдера

goose је AI асистент опште намене који ради на вашем рачунару. Поред кодирања, може да се бави истраживањем, писањем, аутоматизацијом и организацијом података. Можете га користити преко десктоп апликације, терминала или API-ја, а десктоп и терминал верзије деле исту конфигурацију модела. Погодан је за задатке кодирања који се понављају, а такође се може повезати са GitHub-ом, базама података и фајловима.

Пре почетка

goose нуди две опције инсталације: Desktop и CLI. Desktop је графичка верзија са прозором, док се CLI користи уносом команди у терминал. Обе деле исту основну конфигурацију, укључујући провајдера и модел. Провајдер је конфигурација везе која говори goose-у који модел сервиса да користи.

Желите прозор

goose Desktop

Преузмите zip на macOS-у
Или користите brew cask
Користите инсталациони пакет на Linux-у

Само терминал

goose CLI

download_cli.sh
Или Homebrew CLI
Затим покрените goose session

Windows

Прво изаберите окружење

Git Bash или MSYS2
Такође можете користити PowerShell
Ако команда није пронађена, додајте је у PATH

На macOS-у, можете га инсталирати преузимањем апликације или коришћењем Homebrew-а. На Linux-у користите пакет ваше дистрибуције за десктоп верзију. На Windows-у прво проверите подржана терминал окружења.

Пре почетка, припремите ID модела са тренутне листе модела. ID модела је назив који сервис модела користи за идентификацију одређеног модела, и морате копирати комплетан ID када га користите.

Инсталација и прво покретање

Ако желите графички прозор

Постоје два документована метода инсталације за macOS:

Преузмите га са странице за инсталацију. Страница нуди macOS Silicon и macOS Intel верзије. Након преузимања, распакујте zip фајл и покрените апликацију унутра.
Алтернативно, користите Homebrew:

brew install --cask block-goose

Ово преузима исту апликацију и такође може да управља ажурирањима.

Ако користите Apple Mac M3 и прозор се не појављује након отварања апликације, проверите да ли је ~/.config читљив и уписив. goose користи овај директоријум за писање логова.

За Linux десктоп верзију, преузмите је са странице за инсталацију. Доступни пакети су DEB за Ubuntu/Debian, RPM за RHEL/Fedora и Flatpak. На Debian-у или Ubuntu-у, преузмите DEB фајл, отворите директоријум у којем је сачуван, покрените sudo dpkg -i (filename).deb, а затим отворите goose из менија апликација. Замените (filename) стварним називом фајла.

За Windows десктоп верзију, преузмите је са странице за инсталацију, распакујте zip фајл и покрените апликацију унутра.

Ако желите само терминал верзију

На macOS-у и Linux-у, покрените:

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

Да бисте прескочили интерактивну конфигурацију током инсталације, додајте CONFIGURE=false пре bash:

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

На macOS-у такође можете покренути:

brew install block-goose-cli

Да бисте ажурирали инсталирани CLI, покрените:

goose update

На Windows-у је потребно једно од следећа три окружења: Git Bash, који је укључен уз Git for Windows и означен као препоручен; MSYS2; или PowerShell укључен уз Windows 10/11. У Git Bash-у и MSYS2, користите исту download_cli.sh команду приказану изнад. У PowerShell-у, прво преузмите скрипту, а затим је покрените:

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

Ако вам је речено да goose није у PATH-у, пратите страницу за инсталацију и додајте ~/.local/bin или %USERPROFILE%\.local\bin у тренутну конфигурацију shell-а, а затим поново отворите терминал. PATH је скуп директоријума које терминал претражује за програме. Ако инсталациони директоријум није укључен, можда нећете моћи да покренете инсталирани програм уносом његовог назива директно.

На дан 2026-10-09, CLI верзија је била 1.54.0. Подразумевано, инсталациона скрипта поставља програм у ~/.local/bin. Овај директоријум можете променити помоћу GOOSE_BIN_DIR променљиве окружења. Ако га промените, скрипта неће аутоматски ажурирати конфигурацију shell-а, а терминал ће пријавити да директоријум није у PATH-у. Додајте тај директоријум у PATH или покрените goose користећи његову пуну путању.

Први пут када користите goose, тражиће од вас да конфигуришете провајдера. Можете прескочити уграђене провајдере и додати прилагођеног провајдера као што је описано у следећем одељку. У терминалу, идите до директоријума у којем желите да радите и покрените:

goose session

Преузимање вредности везе из OmniProxy-а

Припремите адресу, кључ и назив модела из ваше сопствене OmniProxy инстанце. Пример прилагођеног провајдера користи base_url који се завршава са /v1/chat/completions, тако да овај водич прати исти формат:

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

Копирајте комплетан назив модела са тренутне OmniProxy листе, укључујући све косе црте. На дан 2026-10-09, два референтна ID-ја у документацији провајдера су била grok-4.7 за Grok и gpt-6-luna из OpenAI документације. gpt-6-luna подржава Chat Completions; позивање функција у Chat Completions је подржано само када је reasoning_effort подешено на none. Немојте копирати назив који се не појављује на листи.

Унос конфигурације алата

Прилагођени провајдер може користити OpenAI, Anthropic или Ollama компатибилан формат. Компатибилан формат значи да алат шаље захтеве према уобичајеној API спецификацији. Када се повезујете на OmniProxy, изаберите OpenAI Compatible.

Desktop

Кликните на дугме у горњем левом углу да отворите бочну траку.
Кликните Settings.
Кликните Models.
Кликните Configure providers.
Кликните Add Custom Provider на дну прозора.
За тип провајдера изаберите OpenAI Compatible. Можете подесити Display Name на OmniProxy. Унесите адресу из претходног одељка у API URL. Ако је потребан кључ, изаберите опцију која захтева API кључ и унесите свој OmniProxy кључ. У Available Models, унесите називе модела, раздвајајући више назива зарезима.
Кликните Create Provider.

Десктоп верзија тренутно не може да дефинише прилагођена заглавља захтева у овом прозору. Ако су вам потребна заглавља захтева, уредите конфигурациони фајл након креирања провајдера.

Терминал

Покрените:

goose configure

Изаберите Custom Providers, затим изаберите Add A Custom Provider. За тип API-ја изаберите OpenAI Compatible, а затим пратите упутства да унесете назив, API URL, да ли је потребан кључ, називе модела и да ли су подржани стриминг одговори.

Када конфигуришете ручно на Windows-у, ако keychain пријави грешку, упутства за инсталацију кажу да одбијете чување кључа у keychain-у и уместо тога користите променљиву окружења. Затим поново покрените goose configure . Keychain је мали систем за безбедно складиштење који користи оперативни систем за чување тајни.

Конфигурациони фајл

Документовани директоријуми су:

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

Можете засновати фајл на приложеном примеру. Замените назив, адресу и моделе сопственим вредностима. Чувајте кључ у променљивој окружења наведеној помоћу api_key_env; немојте уписивати прави кључ у фајл:

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

Задржите нумеричку вредност за context_limit, као што је приказано у примеру. Стварно ограничење контекста зависи од модела и OmniProxy-а; немојте третирати пример броја као званично ограничење модела. Пре употребе, покрените:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Након уласка у радни директоријум, покрените:

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

Замените вредност --model комплетним ID-јем са листе. goose session нема start подкоманду. Такође можете подесити --provider и --model преко GOOSE_PROVIDER и GOOSE_MODEL променљивих окружења. Чак и ако гејтвеј не проверава кључеве, OMNIPROXY_API_KEY мора и даље имати вредност. То може бити placeholder стринг који се користи само на вашем локалном рачунару. Ова конфигурација је успешно прочитала фајл током тестирања 2026-10-09.

Прозор

Settings

Settings у бочној траци
Страница Models
Add Custom Provider

Терминал

goose configure

Изаберите Custom Providers
Затим изаберите add
Изаберите OpenAI Compatible као тип

Фајл

custom_providers

На macOS-у и Linux-у је под ~/.config
На Windows-у је под APPDATA
Подесите base_url према званичном примеру

Сва три метода креирају исти тип конфигурације. Изаберите OpenAI Compatible као тип провајдера.

Верификација са стварним задатком

Отворите директоријум који садржи обичан фајл и покрените goose session као што је приказано у претходном одељку. Замолите га да прочита прву линију фајла који наведете. Требало би да врати садржај фајла уместо да само каже да је конфигурација сачувана.

Да бисте читали фајлове или извршавали команде, сесији је потребна Developer екстензија. Developer екстензија је модул алата који омогућава goose-у да ради са локалним фајловима и командама. Обично је укључена у подразумевану конфигурацију. Ако goose каже да нема алате за фајлове, додајте следеће у команду:

--with-builtin developer

Немојте такође додавати --no-profile, јер та опција онемогућава подразумеване екстензије.

У тестирању 2026-10-09, goose 1.54.0 је успешно прочитао прву линију наведеног фајла. Први одговор може трајати око један минут.

Затим проверите OmniProxy логове захтева да бисте потврдили извор и назив модела.

Покретање

Сесија се отвара

goose session
Провајдер је онај који је управо додат
Назив модела је на листи

Задатак

Заправо је завршио задатак

На пример, излистајте тренутни директоријум
Прегледајте његов одговор
Не ослањајте се само на успешно чување

Логови

Видљиви у гејтвеју

Користите адресу из примера документације
Не стављајте кључ у репозиторијум
ID модела се поклапа са листом

Након чувања провајдера, потврдите га стварном сесијом.

Честе грешке

goose команда се не може пронаћи: Додајте инсталациони директоријум у PATH као што је описано на страници за инсталацију, а затим поново отворите терминал.
Прозор се не појављује у десктоп верзији на M3 Mac-у: Проверите дозволе за читање и писање за ~/.config.
Keychain не успева: Не чувајте кључ у keychain-у; уместо тога користите променљиву окружења.
Модел није на листи: У десктоп верзији изаберите Use custom model и унесите назив модела ручно. goose configure не може да прихвати прилагођени назив модела. За употребу у терминалу, пребаците се на десктоп верзију или уредите GOOSE_MODEL директно у конфигурацији.
Адреса се не може достићи: Потврдите да се API URL завршава са /v1/chat/completions, као у примеру, и да је OmniProxy покренут.
Каже да не може да чита фајлове: Додајте Developer екстензију и не користите --no-profile.
Враћа unsupported Responses role: system: Адреса је обично исправна. Пребаците се на други комплетан ID са листе модела.

Званичне референце

За инсталацију, погледајте Install goose. За прилагођене провајдере, погледајте goose providers. За ID-јеве модела који се користе у примерима, погледајте xAI models page и GPT-6 Luna.

Замените сваки чувар места вредностима из ваше OmniProxy конфигурације. Никада не објављујте стварни кључ.

Сачувани резултат или HTTP 200 сами по себи не доказују пуну компатибилност Агента. Проверите извор и модел у запису позива OmniProxy.

Званични извори · goose ↗