goosen asennus ja mukautetun palveluntarjoajan määrittäminen

goose on yleiskäyttöinen tekoälyavustaja, joka toimii tietokoneellasi. Koodauksen lisäksi se voi hoitaa tutkimusta, kirjoittamista, automaatiota ja tiedon järjestämistä. Voit käyttää sitä työpöytäsovelluksen, päätteen tai API:n kautta, ja työpöytä- sekä pääteversiot jakavat saman mallimäärityksen. Se sopii toistuviin koodaustehtäviin ja voi myös yhdistää GitHubiin, tietokantoihin ja tiedostoihin.

Ennen kuin aloitat

goose tarjoaa kaksi asennusvaihtoehtoa: Desktop ja CLI. Desktop on graafinen versio ikkunalla, kun taas CLI:tä käytetään syöttämällä komentoja päätteeseen. Molemmat jakavat saman ydinkokoonpanon, mukaan lukien palveluntarjoajan (Provider) ja mallin. Palveluntarjoaja on yhteysmääritys, joka kertoo gooselle, mitä mallipalvelua käyttää.

Haluat ikkunan

goose Desktop

Lataa zip-tiedosto macOS:llä
Tai käytä brew caskia
Käytä asennuspakettia Linuxilla

Vain pääte

goose CLI

download_cli.sh
Tai Homebrew CLI
Suorita sitten goose session

Windows

Valitse ympäristö ensin

Git Bash tai MSYS2
Voit käyttää myös PowerShelliä
Jos komentoa ei löydy, lisää se PATH-muuttujaan

macOS:llä voit asentaa sen lataamalla sovelluksen tai käyttämällä Homebrew'ta. Linuxilla käytä jakelusi pakettia työpöytäversiolle. Windowsilla tarkista ensin tuetut pääteympäristöt.

Ennen aloittamista, pidä mallitunnus nykyisestä mallilistasta valmiina. Mallitunnus on nimi, jota mallipalvelu käyttää tietyn mallin yksilöimiseen, ja sinun on kopioitava koko tunnus sitä käytettäessä.

Asennus ja ensimmäinen käynnistys

Jos haluat graafisen ikkunan

macOS:lle on kaksi dokumentoitua asennustapaa:

Lataa se asennussivulta. Sivu tarjoaa macOS Silicon- ja macOS Intel -versiot. Lataamisen jälkeen pura zip-tiedosto ja suorita sovellus sen sisällä.
Vaihtoehtoisesti käytä Homebrew’ta:

brew install --cask block-goose

Tämä lataa saman sovelluksen ja voi myös hoitaa päivitykset.

Jos käytät Apple Mac M3:a eikä ikkunaa ilmesty sovelluksen avaamisen jälkeen, tarkista, onko ~/.config luettavissa ja kirjoitettavissa. goose käyttää tätä hakemistoa lokien kirjoittamiseen.

Linux-työpöytäversiota varten lataa se asennussivulta. Saatavilla olevat paketit ovat DEB Ubuntulle/Debianille, RPM RHEL:lle/Fedoralle ja Flatpak. Debianilla tai Ubuntulla lataa DEB-tiedosto, avaa hakemisto, johon se tallennettiin, suorita sudo dpkg -i (filename).deb, ja avaa sitten goose sovellusvalikosta. Korvaa (filename) todellisella tiedostonimellä.

Windows-työpöytäversiota varten lataa se asennussivulta, pura zip-tiedosto ja suorita sovellus sen sisällä.

Jos haluat vain pääteversion

Suorita macOS:llä ja Linuxilla:

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

Ohittaaksesi interaktiivisen määrityksen asennuksen aikana, lisää CONFIGURE=false ennen bash:

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

macOS:llä voit myös suorittaa:

brew install block-goose-cli

Päivittääksesi asennetun CLI:n, suorita:

goose update

Windowsilla vaaditaan yksi seuraavista kolmesta ympäristöstä: Git Bash, joka sisältyy Git for Windowsiin ja on merkitty suositelluksi; MSYS2; tai Windows 10/11:n mukana tuleva PowerShell. Git Bashissa ja MSYS2:ssa käytä samaa download_cli.sh komentoa kuin yllä. PowerShellissä lataa skripti ensin ja suorita se sitten:

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

Jos sinulle kerrotaan, ettei goose ole PATH-muuttujassa, seuraa asennussivua ja lisää ~/.local/bin tai %USERPROFILE%\.local\bin nykyiseen shell-määritykseen ja avaa pääte uudelleen. PATH on joukko hakemistoja, joista pääte etsii ohjelmia. Jos asennushakemistoa ei ole sisällytetty, et ehkä pysty suorittamaan asennettua ohjelmaa syöttämällä sen nimeä suoraan.

Tilanteessa 9.10.2026 CLI-versio oli 1.54.0. Oletuksena asennusskripti sijoittaa ohjelman hakemistoon ~/.local/bin. Voit muuttaa tätä hakemistoa GOOSE_BIN_DIR ympäristömuuttujalla. Jos muutat sitä, skripti ei päivitä shell-määritystä automaattisesti, ja pääte ilmoittaa, ettei hakemisto ole PATH-muuttujassa. Lisää kyseinen hakemisto PATH-muuttujaan tai suorita goose sen koko polulla.

Kun käytät goosea ensimmäistä kertaa, se pyytää sinua määrittämään palveluntarjoajan (Provider). Voit ohittaa sisäänrakennetut palveluntarjoajat ja lisätä mukautetun palveluntarjoajan seuraavassa osiossa kuvatulla tavalla. Siirry päätteessä hakemistoon, jossa haluat työskennellä, ja suorita:

goose session

Hae yhteysarvot OmniProxysta

Valmistele osoite, avain ja mallin nimi omasta OmniProxy-instanssistasi. Mukautetun palveluntarjoajan esimerkki käyttää base_url osoitetta, joka päättyy /v1/chat/completions, joten tämä opas noudattaa samaa muotoa:

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

Kopioi koko mallin nimi nykyisestä OmniProxy-listasta, mukaan lukien kauttaviivat. Tilanteessa 9.10.2026 kaksi viitetunnusta palveluntarjoajan dokumentaatiossa olivat grok-4.7 Grokille ja gpt-6-luna OpenAI-dokumentaatiosta. gpt-6-luna tukee Chat Completionsia; funktioiden kutsuminen Chat Completionsissa on tuettu vain, kun reasoning_effort on asetettu arvoon none. Älä kopioi nimeä, joka ei näy listassa.

Syötä työkalun määritykset

Mukautettu palveluntarjoaja voi käyttää OpenAI-, Anthropic- tai Ollama-yhteensopivaa muotoa. Yhteensopiva muoto tarkoittaa, että työkalu lähettää pyyntöjä yleisen API-määrityksen mukaisesti. Kun yhdistät OmniProxyyn, valitse OpenAI Compatible.

Desktop

Napsauta vasemmassa yläkulmassa olevaa painiketta avataksesi sivupalkin.
Napsauta Settings.
Napsauta Models.
Napsauta Configure providers.
Napsauta ikkunan alareunasta Add Custom Provider.
Valitse Provider Type -kohdasta OpenAI Compatible. Voit asettaa Display Nameksi OmniProxy. Syötä edellisessä osiossa saatu osoite API URL -kenttään. Jos avain vaaditaan, valitse vaihtoehto, joka vaatii API-avaimen, ja syötä OmniProxy-avaimesi. Syötä Available Models -kenttään mallien nimet erotettuna pilkuilla.
Napsauta Create Provider.

Työpöytäversio ei tällä hetkellä pysty määrittämään mukautettuja pyyntöotsikoita tässä ikkunassa. Jos tarvitset pyyntöotsikoita, muokkaa asetustiedostoa palveluntarjoajan luomisen jälkeen.

Pääte

Suorita:

goose configure

Valitse Custom Providers ja sitten Add A Custom Provider. Valitse API Type -kohdasta OpenAI Compatible ja seuraa sitten kehotteita syöttääksesi nimen, API URL -osoitteen, tiedon avaimen tarpeellisuudesta, mallien nimet ja tiedon siitä, tuetaanko suoratoistovastauksia.

Kun määrität manuaalisesti Windowsilla, jos avainnippu (keychain) raportoi virheen, asennusohjeiden mukaan avainta ei tule tallentaa avainnippuun, vaan käyttää sen sijaan ympäristömuuttujaa. Suorita sitten goose configure uudelleen. Avainnippu on käyttöjärjestelmän käyttämä pieni suojattu tallennusjärjestelmä salaisuuksien säilyttämiseen.

Asetustiedosto

Dokumentoidut hakemistot ovat:

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

Voit perustaa tiedoston annettuun esimerkkiin. Korvaa nimi, osoite ja mallit omilla arvoillasi. Säilytä avain ympäristömuuttujassa, joka on määritetty kohdassa api_key_env; älä kirjoita oikeaa avainta tiedostoon:

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

Pidä numeerinen arvo kohdassa context_limit, kuten esimerkissä. Todellinen kontekstiraja riippuu mallista ja OmniProxysta; älä pidä esimerkkinumeroa mallin virallisena rajana. Ennen käyttöä suorita:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Kun olet siirtynyt työhakemistoon, suorita:

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

Korvaa --model arvo koko tunnuksella listasta. goose session ei sisällä start alikomentoa. Voit myös asettaa --provider ja --model ympäristömuuttujien GOOSE_PROVIDER ja GOOSE_MODEL kautta. Vaikka yhdyskäytävä ei validoisi avaimia, OMNIPROXY_API_KEY täytyy silti olla arvo. Se voi olla paikkamerkkimerkkijono, jota käytetään vain paikallisella tietokoneellasi. Tämä määritys luki tiedoston onnistuneesti testauksessa 9.10.2026.

Ikkuna

Settings

Asetukset sivupalkissa
Models-sivu
Lisää mukautettu palveluntarjoaja

Pääte

goose configure

Valitse Custom Providers
Valitse sitten lisäys
Valitse tyypiksi OpenAI Compatible

Tiedosto

custom_providers

macOS:llä ja Linuxilla se on ~/.config-hakemistossa
Windowsilla se on APPDATA-hakemistossa
Aseta base_url virallisen esimerkin mukaan

Kaikki kolme menetelmää luovat saman tyyppisen määrityksen. Valitse palveluntarjoajan tyypiksi OpenAI Compatible.

Vahvista todellisella tehtävällä

Avaa hakemisto, joka sisältää tavallisen tiedoston, ja suorita goose session kuten edellisessä osiossa. Pyydä sitä lukemaan määrittämäsi tiedoston ensimmäinen rivi. Sen pitäisi palauttaa tiedoston sisältö sen sijaan, että se vain sanoisi määrityksen tallennetun.

Tiedostojen lukeminen tai komentojen suorittaminen vaatii Developer-laajennuksen. Developer-laajennus on työkalumoduuli, jonka avulla goose voi työskennellä paikallisten tiedostojen ja komentojen kanssa. Se sisältyy yleensä oletusmääritykseen. Jos goose sanoo, ettei sillä ole tiedostotyökaluja, lisää komentoon seuraava:

--with-builtin developer

Älä lisää myös --no-profile, koska kyseinen valinta poistaa oletuslaajennukset käytöstä.

Testauksessa 9.10.2026 goose 1.54.0 luki onnistuneesti määritetyn tiedoston ensimmäisen rivin. Ensimmäinen vastaus voi kestää noin minuutin.

Tarkista sitten OmniProxyn pyyntölokit varmistaaksesi lähteen ja mallin nimen.

Käynnistys

Istunto avautuu

goose session
Palveluntarjoaja on juuri lisätty
Mallin nimi on listassa

Tehtävä

Se suoritti tehtävän todellisuudessa

Esimerkiksi listaa nykyinen hakemisto
Tarkista sen vastaus
Älä luota vain onnistuneeseen tallennukseen

Lokit

Näkyvissä yhdyskäytävässä

Käytä dokumentaatioesimerkin osoitetta
Älä laita avainta arkistoon
Mallitunnus täsmää listaan

Kun olet tallentanut palveluntarjoajan, vahvista se todellisella istunnolla.

Yleiset virheet

goose komentoa ei löydy: Lisää asennushakemisto PATH-muuttujaan asennussivun ohjeiden mukaisesti ja avaa pääte uudelleen.
Työpöytäversiossa ei näy ikkunaa M3 Macilla: Tarkista luku- ja kirjoitusoikeudet hakemistolle ~/.config.
Avainnippu epäonnistuu: Älä tallenna avainta avainnippuun; käytä sen sijaan ympäristömuuttujaa.
Mallia ei ole listassa: Valitse työpöytäversiossa Use custom model ja syötä mallin nimi manuaalisesti. goose configure ei voi hyväksyä mukautettua mallin nimeä. Päätekäyttöä varten vaihda työpöytäversioon tai muokkaa GOOSE_MODEL suoraan asetuksissa.
Osoitteeseen ei saada yhteyttä: Varmista, että API URL päättyy /v1/chat/completions, kuten esimerkissä, ja että OmniProxy on käynnissä.
Se sanoo, ettei voi lukea tiedostoja: Lisää Developer-laajennus äläkä käytä --no-profile.
Se palauttaa unsupported Responses role: system: Osoite on yleensä oikein. Vaihda toiseen koko tunnukseen mallilistasta.

Viralliset viitteet

Katso asennus kohdasta Install goose. Katso mukautetut palveluntarjoajat kohdasta goose providers. Katso esimerkeissä käytetyt mallitunnukset kohdista xAI models page ja GPT-6 Luna.

Korvaa jokainen paikanpitäjä arvoilla omasta OmniProxy-konfiguraatiostasi. Älä koskaan julkaise todellista avainta.

Tallennettu tulos tai HTTP 200 -vastaus ei yksinään todista täydellistä Agent-yhteensopivuutta. Tarkista lähde ja malli OmniProxyn kutsulogista.

Viralliset lähteet · goose ↗