Instalarea goose și configurarea unui furnizor personalizat

goose este un asistent AI de uz general care rulează pe computerul tău. Pe lângă programare, poate gestiona cercetarea, scrierea, automatizarea și organizarea datelor. Îl poți folosi prin aplicația desktop, terminal sau API, iar versiunile desktop și terminal partajează aceeași configurație de model. Este potrivit pentru sarcini repetitive de programare și se poate conecta, de asemenea, la GitHub, baze de date și fișiere.

Înainte de a începe

goose oferă două opțiuni de instalare: Desktop și CLI. Desktop este versiunea grafică cu fereastră, în timp ce CLI este utilizată prin introducerea comenzilor într-un terminal. Ambele partajează aceeași configurație de bază, inclusiv Furnizorul și modelul. Un Furnizor este configurația de conexiune care îi spune lui goose ce serviciu de model să folosească.

Dorești o fereastră

goose Desktop

• Descarcă zip-ul pe macOS
• Sau folosește brew cask
• Folosește pachetul de instalare pe Linux

Doar terminal

goose CLI

• download_cli.sh
• Sau CLI-ul Homebrew
• Apoi rulează goose session

Windows

Alege mai întâi un mediu

• Git Bash sau MSYS2
• Poți folosi și PowerShell
• Dacă comanda nu este găsită, adaug-o în PATH

Înainte de a începe, pregătește ID-ul modelului din lista curentă de modele. Un ID de model este numele pe care serviciul de model îl folosește pentru a identifica un anumit model și trebuie să copiezi ID-ul complet atunci când îl folosești.

Instalare și prima lansare

Dacă dorești o fereastră grafică

Există două metode de instalare documentate pentru macOS:

• Descarcă-l de pe pagina de instalare. Pagina oferă versiuni pentru macOS Silicon și macOS Intel. După descărcare, extrage fișierul zip și rulează aplicația din interior.
• Alternativ, folosește Homebrew:

brew install --cask block-goose

Aceasta descarcă aceeași aplicație și poate gestiona și actualizările.

Dacă folosești un Apple Mac M3 și nu apare nicio fereastră după deschiderea aplicației, verifică dacă ~/.config este citibil și scriibil. goose folosește acest director pentru a scrie jurnale.

Pentru versiunea desktop de Linux, descarcă-o de pe pagina de instalare. Pachetele disponibile sunt DEB pentru Ubuntu/Debian, RPM pentru RHEL/Fedora și Flatpak. Pe Debian sau Ubuntu, descarcă fișierul DEB, deschide directorul unde a fost salvat, rulează sudo dpkg -i (filename).deb, apoi deschide goose din meniul de aplicații. Înlocuiește (filename) cu numele real al fișierului.

Pentru versiunea desktop de Windows, descarcă-o de pe pagina de instalare, extrage fișierul zip și rulează aplicația din interior.

Dacă dorești doar versiunea de terminal

Pe macOS și Linux, rulează:

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

Pentru a sări peste configurarea interactivă în timpul instalării, adaugă CONFIGURE=false înainte de bash:

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

Pe macOS, poți rula și:

brew install block-goose-cli

Pentru a actualiza un CLI instalat, rulează:

goose update

Pe Windows, este necesar unul dintre următoarele trei medii: Git Bash, care este inclus cu Git for Windows și marcat ca recomandat; MSYS2; sau PowerShell inclus cu Windows 10/11. În Git Bash și MSYS2, folosește aceeași download_cli.sh comandă prezentată mai sus. În PowerShell, descarcă mai întâi scriptul și apoi rulează-l:

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

Dacă ți se spune că goose nu este în PATH, urmează pagina de instalare și adaugă ~/.local/bin sau %USERPROFILE%\.local\bin la configurația curentă a shell-ului, apoi redeschide terminalul. PATH este un set de directoare pe care terminalul le caută pentru programe. Dacă directorul de instalare nu este inclus, este posibil să nu poți rula un program instalat introducând numele acestuia direct.

La data de 2026-10-09, versiunea CLI era 1.54.0. În mod implicit, scriptul de instalare plasează programul în ~/.local/bin. Poți schimba acest director cu variabila de mediu GOOSE_BIN_DIR . Dacă îl schimbi, scriptul nu va actualiza automat configurația shell-ului, iar terminalul va raporta că directorul nu este în PATH. Adaugă acel director în PATH sau rulează goose folosind calea sa completă.

Prima dată când folosești goose, acesta îți va cere să configurezi un Furnizor. Poți sări peste furnizorii încorporați și să adaugi un Furnizor personalizat așa cum este descris în secțiunea următoare. În terminal, navighează la directorul în care dorești să lucrezi și rulează:

goose session

Obținerea valorilor de conexiune din OmniProxy

Pregătește adresa, cheia și numele modelului din propria ta instanță OmniProxy. Exemplul de Furnizor personalizat folosește un base_url care se termină în /v1/chat/completions, deci acest ghid urmează același 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

Copiază numele complet al modelului din lista curentă OmniProxy, inclusiv orice bare oblice. La data de 2026-10-09, două ID-uri de referință din documentația furnizorului erau grok-4.7 pentru Grok și gpt-6-luna din documentația OpenAI. gpt-6-luna acceptă Chat Completions; apelarea funcțiilor în Chat Completions este acceptată doar când reasoning_effort este setat la none. Nu copia un nume care nu apare în listă.

Introducerea configurației instrumentului

Un Furnizor personalizat poate folosi un format compatibil OpenAI, Anthropic sau Ollama. Un format compatibil înseamnă că instrumentul trimite cereri conform unei specificații API comune. Când te conectezi la OmniProxy, selectează OpenAI Compatible.

Desktop

1. Dă clic pe butonul din colțul din stânga sus pentru a deschide bara laterală.
2. Dă clic pe Settings.
3. Dă clic pe Models.
4. Dă clic pe Configure providers.
5. Dă clic pe Add Custom Provider în partea de jos a ferestrei.
6. Pentru Provider Type, selectează OpenAI Compatible. Poți seta Display Name la OmniProxy. Introdu adresa din secțiunea anterioară în API URL. Dacă este necesară o cheie, selectează opțiunea care necesită o cheie API și introdu cheia OmniProxy. În Available Models, introdu numele modelelor, separând numele multiple prin virgule.
7. Dă clic pe Create Provider.

Versiunea desktop nu poate defini în prezent antete de cerere personalizate în această fereastră. Dacă ai nevoie de antete de cerere, editează fișierul de configurare după crearea Furnizorului.

Terminal

Rulează:

goose configure

Selectează Custom Providers, apoi selectează Add A Custom Provider. Pentru API Type, selectează OpenAI Compatible, apoi urmează instrucțiunile pentru a introduce numele, API URL, dacă este necesară o cheie, numele modelelor și dacă răspunsurile în flux (streaming) sunt acceptate.

Când configurezi manual pe Windows, dacă brelocul (keychain) raportează o eroare, instrucțiunile de instalare spun să refuzi salvarea cheii în breloc și să folosești în schimb o variabilă de mediu. Apoi rulează goose configure din nou. Brelocul este un mic sistem de stocare securizat utilizat de sistemul de operare pentru a stoca secrete.

Fișier de configurare

Directoarele documentate sunt:

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

Poți baza fișierul pe exemplul furnizat. Înlocuiește numele, adresa și modelele cu propriile tale valori. Stochează cheia în variabila de mediu specificată de api_key_env; nu scrie cheia reală în fișier:

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

Păstrează o valoare numerică pentru context_limit, așa cum se arată în exemplu. Limita reală de context depinde de model și de OmniProxy; nu trata numărul din exemplu ca fiind limita oficială a modelului. Înainte de a-l folosi, rulează:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

După introducerea directorului de lucru, rulează:

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

Înlocuiește valoarea lui --model cu ID-ul complet din listă. goose session nu are o start subcomandă. Poți seta și --provider și --model prin GOOSE_PROVIDER și GOOSE_MODEL variabile de mediu. Chiar dacă gateway-ul nu validează cheile, OMNIPROXY_API_KEY trebuie să aibă totuși o valoare. Poate fi un șir de caractere substituent utilizat doar pe computerul tău local. Această configurație a citit cu succes un fișier în testare la data de 2026-10-09.

Fereastră

Setări

• Setări în bara laterală
• Pagina Modele
• Adaugă Furnizor Personalizat

Terminal

goose configure

• Selectează Furnizori Personalizați
• Apoi selectează adăugare
• Alege OpenAI Compatible ca tip

Fișier

custom_providers

• Pe macOS și Linux, este sub ~/.config
• Pe Windows, este sub APPDATA
• Setează base_url conform exemplului oficial

Verificarea cu o sarcină reală

Deschide un director care conține un fișier obișnuit și rulează goose session așa cum se arată în secțiunea anterioară. Cere-i să citească prima linie a unui fișier pe care îl specifici. Ar trebui să returneze conținutul fișierului în loc să spună doar că configurația a fost salvată.

Pentru a citi fișiere sau a executa comenzi, sesiunea are nevoie de extensia Developer. Extensia Developer este un modul de instrumente care îi permite lui goose să lucreze cu fișiere și comenzi locale. Este inclusă în general în configurația implicită. Dacă goose spune că nu are instrumente pentru fișiere, adaugă următoarele la comandă:

--with-builtin developer

Nu adăuga și --no-profile, deoarece acea opțiune dezactivează extensiile implicite.

În testarea din 2026-10-09, goose 1.54.0 a citit cu succes prima linie a fișierului specificat. Primul răspuns poate dura aproximativ un minut.

Apoi verifică jurnalele de cereri OmniProxy pentru a confirma sursa și numele modelului.

Lansare

O sesiune se deschide

• goose session
• Furnizorul este cel tocmai adăugat
• Numele modelului este în listă

Sarcină

A finalizat efectiv sarcina

• De exemplu, listează directorul curent
• Revizuiește răspunsul său
• Nu te baza doar pe o salvare reușită

Jurnale

Vizibile în gateway

• Folosește adresa din exemplul de documentație
• Nu pune cheia în depozit
• ID-ul modelului se potrivește cu lista

Erori comune

• Comanda goose nu poate fi găsită: Adaugă directorul de instalare în PATH așa cum este descris pe pagina de instalare, apoi redeschide terminalul.
• Nu apare nicio fereastră în versiunea desktop pe un Mac M3: Verifică permisiunile de citire și scriere pentru ~/.config.
• Keychain-ul eșuează: Nu salva cheia în keychain; folosește în schimb o variabilă de mediu.
• Modelul nu este în listă: În versiunea desktop, selectează Use custom model și introdu numele modelului manual. goose configure nu poate accepta un nume de model personalizat. Pentru utilizarea în terminal, treci la versiunea desktop sau editează GOOSE_MODEL direct în configurație.
• Adresa nu poate fi atinsă: Confirmă că API URL se termină în /v1/chat/completions, ca în exemplu, și că OmniProxy rulează.
• Spune că nu poate citi fișiere: Adaugă extensia Developer și nu folosi --no-profile.
• Returnează unsupported Responses role: system: Adresa este de obicei corectă. Treci la un alt ID complet din lista de modele.

Referințe oficiale

Pentru instalare, vezi Instalare goose. Pentru Furnizori personalizați, vezi furnizori goose. Pentru ID-urile modelelor utilizate în exemple, vezi pagina modelelor xAI și GPT-6 Luna.

Înlocuiește fiecare spațiu rezervat cu valori din propria ta configurare OmniProxy. Nu publica niciodată o cheie reală.

Un rezultat salvat sau HTTP 200 singur nu dovedește compatibilitatea completă a Agentului. Verifică sursa și modelul în înregistrarea de apeluri OmniProxy.

Surse oficiale · goose ↗