goose kurulumu ve özel Provider yapılandırması

goose, bilgisayarınızda çalışan genel amaçlı bir AI asistanıdır. Kodlamanın yanı sıra arama, yazma, otomasyon ve veri düzenleme işlerini de yapabilir. Masaüstü sürümü, terminal veya API üzerinden kullanılabilir; masaüstü ve terminal sürümleri aynı model yapılandırmasını paylaşır. Tekrarlanan kodlama görevleri için uygundur ve GitHub’a, veritabanlarına ve dosyalara bağlanabilir.

Kurulum öncesi hazırlık

goose, Desktop ve CLI olmak üzere iki kurulum seçeneği sunar. Desktop, pencereli masaüstü sürümüdür; CLI ise terminale komut girerek kullanılan sürümdür. Her ikisi de Provider ve model dâhil olmak üzere aynı temel yapılandırmayı paylaşır. Provider, “goose’a hangi model hizmetini kullanacağını bildiren” bağlantı yapılandırması olarak düşünülebilir.

Pencere istiyorsanız

goose Desktop

• macOS için zip indirin
• Veya brew cask kullanın
• Linux'ta kurulum paketini kullanın

Yalnızca terminal istiyorsanız

goose CLI

• download_cli.sh
• Veya Homebrew CLI
• Ardından goose session

Windows

Önce ortamı seçin

• Git Bash veya MSYS2
• PowerShell da kullanılabilir
• Komut bulunamazsa PATH'e ekleyin

Başlamadan önce güncel model listesindeki model ID’sini hazırlayın. Model ID, model hizmetinin belirli bir modeli tanımak için kullandığı addır ve kullanılırken eksiksiz kopyalanmalıdır.

Kurulum ve ilk çalıştırma

Pencereli sürüm istiyorsanız

macOS için iki kurulum yolu vardır:

• Kurulum sayfasından indirin. Sayfada macOS Silicon ve macOS Intel seçenekleri bulunur. İndirdikten sonra zip dosyasını çıkarın ve içindeki uygulamayı çalıştırın.
• Alternatif olarak Homebrew kullanın:

brew install --cask block-goose

Bu yöntem aynı uygulamayı indirir ve güncellemelerin yönetilmesine de yardımcı olur.

Apple Mac M3 kullanıyorsanız ve uygulamayı açtıktan sonra pencere görünmüyorsa ~/.config dizininin okunabilir ve yazılabilir olduğunu kontrol edin. goose günlükleri bu dizine yazar.

Linux masaüstü sürümünü kurulum sayfasından indirin. DEB (Ubuntu/Debian), RPM (RHEL/Fedora) ve Flatpak seçenekleri listelenir. Debian veya Ubuntu’da şu adımları izleyin: DEB dosyasını indirin, kaydedildiği dizine gidin, sudo dpkg -i (filename).deb komutunu çalıştırın ve ardından uygulama menüsünden goose’u açın. (filename) bölümünü gerçek dosya adıyla değiştirin.

Windows masaüstü sürümünü kurulum sayfasından indirin, zip dosyasını çıkarın ve içindeki uygulamayı çalıştırın.

Yalnızca terminal istiyorsanız

macOS ve Linux’ta şunu çalıştırın:

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

Kurulum sırasında etkileşimli yapılandırma yapmak istemiyorsanız komutun başına CONFIGURE=false ekleyin:

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

macOS’ta ayrıca şunu çalıştırabilirsiniz:

brew install block-goose-cli

Kurulu CLI’ı güncellemek için:

goose update

Windows’ta şu üç ortamdan biri gereklidir: Git Bash (Git for Windows ile birlikte gelir ve önerilen seçenek olarak işaretlenmiştir), MSYS2 veya Windows 10/11 ile birlikte gelen PowerShell. Git Bash ve MSYS2’de yukarıdaki aynı download_cli.sh komutunu kullanın. PowerShell’de ise önce betiği indirip ardından çalıştırın:

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

goose’un PATH içinde olmadığına dair bir uyarı alırsanız kurulum sayfasındaki yönergeleri izleyerek ~/.local/bin veya %USERPROFILE%\.local\bin dizinini geçerli shell yapılandırmasına ekleyin ve terminali yeniden açın. PATH, terminalin programları aradığı dizinler kümesidir. Dizin PATH’e eklenmemişse program kurulu olsa bile adını doğrudan yazarak çalıştıramayabilirsiniz.

2026-10-09 tarihindeki CLI sürümü 1.54.0’dır. Kurulum betiği programı varsayılan olarak ~/.local/bin dizinine yerleştirir. Bu dizini GOOSE_BIN_DIR ortam değişkeniyle değiştirebilirsiniz. Değiştirdiğinizde betik shell yapılandırmasını otomatik olarak güncellemez ve terminal, dizinin PATH içinde olmadığını bildirir. İlgili dizini PATH’e ekleyin veya programı tam yoluyla çalıştırın.

İlk kullanımda goose sizden bir Provider yapılandırmanızı ister. Yerleşik sağlayıcıları şimdilik atlayıp sonraki bölümde özel bir Provider ekleyebilirsiniz. Terminalde çalışmak istediğiniz dizine gidin ve şunu çalıştırın:

goose session

OmniProxy’den bağlantı değerlerini alma

Kendi OmniProxy kurulumunuzdan adresi, anahtarı ve model adını hazırlayın. Özel Provider örneğinde base_url, /v1/chat/completions ile bitecek şekilde yazıldığından burada da aynı biçim kullanılır:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Güncel OmniProxy model listesinden kopyalayın; birden fazlaysa İngilizce virgülle ayırın

Model adını güncel OmniProxy listesinden eksiksiz kopyalayın ve eğik çizgileri koruyun. 2026-10-09 tarihindeki sağlayıcı belgelerinde karşılaştırma için verilen iki ID, Grok’un grok-4.7 modeli ile OpenAI belgelerindeki gpt-6-luna modelidir. gpt-6-luna, Chat Completions’ı destekler. Chat Completions içinde işlev çağrısı yalnızca reasoning_effort değeri none olduğunda desteklenir. Listede bulunmayan adları doğrudan kopyalamayın.

Araç yapılandırmasını doldurma

Özel Provider, OpenAI, Anthropic veya Ollama uyumlu biçimleri kullanır. Uyumlu biçim, aracın istekleri belirli bir genel API biçimine göre göndermesi olarak düşünülebilir. OmniProxy’ye bağlanırken OpenAI Compatible seçeneğini belirleyin.

Masaüstü sürümü

1. Sol üst köşedeki düğmeye tıklayarak kenar çubuğunu açın.
2. Settings seçeneğine tıklayın.
3. Models seçeneğine tıklayın.
4. Configure providers seçeneğine tıklayın.
5. Pencerenin altındaki Add Custom Provider seçeneğine tıklayın.
6. Provider Type olarak OpenAI Compatible seçin. Display Name alanına OmniProxy yazabilirsiniz. API URL alanına önceki bölümdeki adresi girin. Anahtar gerekiyorsa API Key gerektiren seçeneği işaretleyin ve OmniProxy anahtarını girin. Available Models alanına model adlarını yazın; birden fazlaysa İngilizce virgülle ayırın.
7. Create Provider seçeneğine tıklayın.

Masaüstü sürümünde şu anda bu pencereden özel istek başlıkları tanımlanamaz. İstek başlıkları gerekiyorsa Provider’ı oluşturduktan sonra yapılandırma dosyasını düzenleyin.

Terminal

Şunu çalıştırın:

goose configure

Custom Providers seçeneğini, ardından Add A Custom Provider seçeneğini belirleyin. API Type olarak OpenAI Compatible seçin. Daha sonra istemleri izleyerek adı, API URL’yi, anahtar gerekip gerekmediğini, model adlarını ve akışlı yanıt desteğini girin.

Windows’ta elle yapılandırma sırasında keyring hatası oluşursa anahtarın keyring’e kaydedilip kaydedilmeyeceği sorulduğunda kaydetmemeyi seçin ve bunun yerine bir ortam değişkeni kullanın. Ardından goose configure komutunu yeniden çalıştırın. Keyring, anahtarları saklamak için kullanılan küçük ve güvenli bir sistem deposudur.

Yapılandırma dosyası

Belirtilen dizinler şunlardır:

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

Dosyayı verilen örneğe göre hazırlayabilirsiniz. Adı, adresi ve modelleri kendi değerlerinizle değiştirin. Anahtarı api_key_env ile belirtilen ortam değişkeninde saklayın; gerçek anahtarı dosyaya yazmayın:

{
  "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 için örnekteki gibi bir sayı bırakın. Gerçek bağlam sınırı modele ve OmniProxy’ye bağlıdır; bu örnek değeri modelin resmî üst sınırı olarak kabul etmeyin. Kullanmadan önce şunu çalıştırın:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Çalışma dizinine girdikten sonra:

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

--model değerini listedeki eksiksiz ID ile değiştirin. goose session komutunun start adlı bir alt komutu yoktur. --provider ve --model değerleri, GOOSE_PROVIDER ve GOOSE_MODEL ortam değişkenleriyle de belirtilebilir. Ağ geçidi anahtarı doğrulamasa bile OMNIPROXY_API_KEY bir değere sahip olmalıdır; yalnızca yerel olarak kullanılan bir yer tutucu karakter dizisi olabilir. 2026-10-09 tarihinde bu yapılandırmayla dosya başarıyla okundu.

Pencere

Ayarlar

• Kenar çubuğundaki Ayarlar
• Modeller sayfası
• Özel Sağlayıcı Ekle

Terminal

goose configure

• Özel Sağlayıcılar'ı seçin
• Ardından eklemeyi seçin
• Tür olarak OpenAI Uyumlu'yu seçin

Dosya

custom_providers

• macOS ve Linux'ta ~/.config altında
• Windows'ta APPDATA altında
• base_url için resmi örneği kullanın

Gerçek bir görevle doğrulama

Normal bir dosya içeren dizine gidin ve önceki bölümdeki goose session komutunu çalıştırın. Belirttiğiniz dosyanın ilk satırını okumasını isteyin. Yalnızca yapılandırmanın kaydedildiğini bildirmek yerine dosyanın içeriğini vermelidir.

Dosyaları okumak veya komutları çalıştırmak için oturumda Developer uzantısı gerekir. Developer uzantısı, goose’un yerel dosyaları ve komutları işlemesini sağlayan bir araç modülü olarak düşünülebilir. Varsayılan yapılandırmada genellikle etkindir. goose dosya araçlarına sahip olmadığını söylerse komuta şunu ekleyin:

--with-builtin developer

Aynı anda --no-profile eklemeyin; bu parametre varsayılan uzantıları kapatır.

2026-10-09 tarihinde goose 1.54.0 kullanılarak belirtilen dosyanın ilk satırı okundu. İlk yanıt yaklaşık bir dakika sürebilir.

Ardından OmniProxy çağrı kayıtlarından kaynağı ve model adını doğrulayın.

Başlatma

Oturuma girilebiliyor

• goose session
• Sağlayıcı, az önce eklenen sağlayıcı
• Model adı listede

Görev

Görevi gerçekten yaptı

• Örneğin geçerli dizini listeledi
• Yanıtını inceleyin
• Yalnızca kaydetmenin başarılı olmasına bakmayın

Kayıtlar

Ağ geçidinde görünüyor

• Adres için dokümandaki örneği esas alın
• Anahtarı depoya yazmayın
• Model ID listeyle eşleşiyor

Yaygın hatalar

• goose komutu bulunamıyor: Kurulum sayfasındaki yönergeleri izleyerek kurulum dizinini PATH’e ekleyin ve terminali yeniden açın.
• M3 masaüstü sürümünde pencere görünmüyor: ~/.config dizininin okuma ve yazma izinlerini kontrol edin.
• Keyring başarısız oluyor: Anahtarı keyring’e kaydetmeyin; bunun yerine bir ortam değişkeni kullanın.
• Model listede yok: Masaüstü sürümünde Use custom model seçeneğini belirleyerek model adını elle girebilirsiniz. goose configure ile özel model adı girilemez. Terminal için masaüstü sürümünü kullanın veya yapılandırmadaki GOOSE_MODEL değerini doğrudan değiştirin.
• Adrese bağlanılamıyor: API URL’nin örnekteki gibi /v1/chat/completions ile bittiğini ve OmniProxy’nin çalıştığını doğrulayın.
• Dosyayı okuyamadığını söylüyor: Developer uzantısını ekleyin ve --no-profile kullanmayın.
• unsupported Responses role: system hatası dönüyor: Adres genellikle doğrudur. Model listesindeki başka bir eksiksiz ID’yi deneyin.

Resmî kaynaklar

Kurulum için Install goose sayfasına bakın. Özel Provider yapılandırması için goose providers sayfasına bakın. Örneklerde kullanılan model ID’leri için xAI model sayfasına ve GPT-6 Luna sayfasına bakın.

Tüm yer tutucuları kendi OmniProxy yapılandırmanızdaki değerlerle değiştirin. Gerçek bir anahtar asla paylaşmayın.

Kaydedilmiş bir sonuç veya yalnızca HTTP 200, tam Aracı uyumluluğunu kanıtlamaz. OmniProxy'nin çağrı kaydındaki kaynağı ve modeli kontrol edin.

Resmi kaynaklar · goose ↗