Инсталиране на goose и конфигуриране на персонализиран доставчик

goose е AI асистент с общо предназначение, който работи на вашия компютър. В допълнение към кодирането, той може да се справя с проучвания, писане, автоматизация и организиране на данни. Можете да го използвате чрез настолното приложение, терминала или API, като настолната и терминалната версия споделят една и съща конфигурация на модела. Той е подходящ за повтарящи се задачи по кодиране и може също да се свързва с GitHub, бази данни и файлове.

Преди да започнете

goose предлага две опции за инсталация: Desktop и CLI. Desktop е графичната версия с прозорец, докато CLI се използва чрез въвеждане на команди в терминал. И двете споделят една и съща основна конфигурация, включително доставчика (Provider) и модела. Доставчикът е конфигурацията за връзка, която казва на 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 променливата на средата. Ако я промените, скриптът няма автоматично да актуализира конфигурацията на обвивката и терминалът ще съобщи, че директорията не е в PATH. Добавете тази директория към PATH или стартирайте goose, като използвате пълния ѝ път.

Първия път, когато използвате goose, той ще ви помоли да конфигурирате доставчик (Provider). Можете да пропуснете вградените доставчици и да добавите персонализиран доставчик, както е описано в следващия раздел. В терминала отидете до директорията, в която искате да работите, и изпълнете:

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; извикването на функции (function calling) в Chat Completions се поддържа само когато reasoning_effort е зададено на none. Не копирайте име, което не се появява в списъка.

Въвеждане на конфигурацията на инструмента

Персонализираният доставчик може да използва формат, съвместим с OpenAI, Anthropic или Ollama. Съвместим формат означава, че инструментът изпраща заявки според обща API спецификация. Когато се свързвате с OmniProxy, изберете OpenAI Compatible.

Desktop

Кликнете върху бутона в горния ляв ъгъл, за да отворите страничната лента.
Кликнете Settings.
Кликнете Models.
Кликнете Configure providers.
Кликнете Add Custom Provider в долната част на прозореца.
За Provider Type изберете OpenAI Compatible. Можете да зададете Display Name на OmniProxy. Въведете адреса от предишния раздел в API URL. Ако се изисква ключ, изберете опцията, изискваща API Key, и въведете вашия ключ за OmniProxy. В Available Models въведете имената на моделите, като разделяте множество имена със запетаи.
Кликнете Create Provider.

Настолната версия в момента не може да дефинира персонализирани заглавки на заявки (request headers) в този прозорец. Ако имате нужда от заглавки на заявки, редактирайте конфигурационния файл след създаването на доставчика.

Терминал

Изпълнете:

goose configure

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

Когато конфигурирате ръчно на Windows, ако ключодържателят (keychain) съобщи за грешка, инструкциите за инсталиране казват да откажете запазването на ключа в ключодържателя и вместо това да използвате променлива на средата. След това изпълнете goose configure отново. Ключодържателят е малка система за сигурно съхранение, използвана от операционната система за съхранение на тайни.

Конфигурационен файл

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

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 все още трябва да има стойност. Това може да бъде заместващ низ, използван само на вашия локален компютър. Тази конфигурация успешно прочете файл при тестване на 2026-10-09.

Прозорец

Настройки

Настройки в страничната лента
Страница с модели
Добавяне на персонализиран доставчик

Терминал

goose configure

Изберете Custom Providers
След това изберете добавяне
Изберете 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.
Ключодържателят се проваля: Не запазвайте ключа в ключодържателя; използвайте променлива на средата вместо това.
Моделът не е в списъка: В настолната версия изберете Use custom model и въведете името на модела ръчно. goose configure не може да приеме персонализирано име на модел. За използване в терминал превключете към настолната версия или редактирайте GOOSE_MODEL директно в конфигурацията.
Адресът не може да бъде достигнат: Потвърдете, че API URL завършва на /v1/chat/completions, както е в примера, и че OmniProxy работи.
Казва, че не може да чете файлове: Добавете разширението Developer и не използвайте --no-profile.
Връща unsupported Responses role: system: Адресът обикновено е правилен. Превключете към друг пълен ID от списъка с модели.

Официални справки

За инсталация вижте Инсталиране на goose. За персонализирани доставчици вижте goose providers. За ID-тата на моделите, използвани в примерите, вижте страницата с модели на xAI и GPT-6 Luna.

Заменете всяка плейсхолдер стойност със стойности от вашата собствена конфигурация на OmniProxy. Никога не публикувайте истински ключ.

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

Официални източници · goose ↗