Instalasi goose dan Konfigurasi Provider Kustom

goose adalah asisten AI serbaguna yang berjalan di komputer Anda. Selain menangani kode, goose juga dapat melakukan pencarian, menulis, mengotomatiskan pekerjaan, dan mengelola data. Anda dapat menggunakannya melalui aplikasi desktop, terminal, atau API. Versi desktop dan terminal memakai konfigurasi model yang sama. goose cocok untuk menangani pekerjaan pemrograman berulang serta dapat terhubung ke GitHub, basis data, dan file.

Persiapan sebelum instalasi

goose menyediakan dua metode instalasi: Desktop dan CLI. Desktop adalah versi aplikasi dengan jendela antarmuka, sedangkan CLI digunakan dengan memasukkan perintah di terminal. Keduanya memakai konfigurasi inti yang sama, termasuk Provider dan model. Provider dapat dipahami sebagai konfigurasi koneksi yang memberi tahu goose layanan model mana yang harus digunakan.

Jika menginginkan jendela

goose Desktop

• Unduh zip untuk macOS
• Atau gunakan brew cask
• Gunakan paket instalasi untuk Linux

Jika hanya memerlukan terminal

goose CLI

• download_cli.sh
• Atau Homebrew CLI
• Lalu jalankan goose session

Windows

Pilih lingkungan terlebih dahulu

• Git Bash atau MSYS2
• PowerShell juga dapat digunakan
• Tambahkan ke PATH jika perintah tidak ditemukan

Sebelum memulai, siapkan ID model dari daftar model yang tersedia saat ini. ID model adalah nama yang digunakan layanan model untuk mengidentifikasi model tertentu dan harus disalin secara lengkap saat digunakan.

Instalasi dan peluncuran pertama

Jika menginginkan aplikasi berjendela

Untuk macOS, tersedia dua metode instalasi:

• Unduh dari halaman instalasi. Halaman tersebut menyediakan versi macOS Silicon dan macOS Intel. Setelah mengunduh, ekstrak file zip lalu jalankan aplikasi di dalamnya.
• Atau gunakan Homebrew:

brew install --cask block-goose

Perintah tersebut mengunduh aplikasi yang sama dan sekaligus dapat menangani pembaruan.

Jika Anda menggunakan Apple Mac M3 dan tidak ada jendela yang muncul setelah aplikasi dibuka, periksa apakah ~/.config dapat dibaca dan ditulis. goose menggunakan direktori ini untuk menulis log.

Untuk versi desktop Linux, unduh paket dari halaman instalasi. Paket yang tersedia meliputi DEB (Ubuntu/Debian), RPM (RHEL/Fedora), dan Flatpak. Di Debian atau Ubuntu, langkah-langkahnya adalah: unduh DEB, buka direktori tempat file tersebut disimpan, jalankan sudo dpkg -i (filename).deb, lalu buka goose dari menu aplikasi. Ganti (filename) dengan nama file sebenarnya.

Untuk versi desktop Windows, unduh dari halaman instalasi, ekstrak file zip, lalu jalankan aplikasi di dalamnya.

Jika hanya memerlukan terminal

Di macOS dan Linux, jalankan:

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

Jika tidak ingin melakukan konfigurasi interaktif selama instalasi, tambahkan CONFIGURE=false di depannya:

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

Di macOS, Anda juga dapat menjalankan:

brew install block-goose-cli

Untuk memperbarui CLI yang sudah terinstal, gunakan:

goose update

Di Windows, diperlukan salah satu dari tiga lingkungan berikut: Git Bash yang disertakan bersama Git for Windows dan ditandai sebagai pilihan yang direkomendasikan, MSYS2, atau PowerShell bawaan Windows 10/11. Untuk Git Bash dan MSYS2, gunakan perintah download_cli.sh yang sama seperti di atas. Untuk PowerShell, unduh skrip terlebih dahulu lalu jalankan:

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

Jika muncul pesan bahwa goose tidak ada di PATH, ikuti petunjuk pada halaman instalasi untuk menambahkan ~/.local/bin atau %USERPROFILE%\.local\bin ke konfigurasi shell saat ini, lalu buka ulang terminal. PATH adalah sekumpulan direktori yang digunakan terminal untuk mencari lokasi program. Jika direktori belum ditambahkan, program mungkin tidak dapat dijalankan langsung dengan namanya meskipun sudah terinstal.

Pada 2026-10-09, versi CLI adalah 1.54.0. Secara default, skrip instalasi menempatkan program di ~/.local/bin. Variabel lingkungan GOOSE_BIN_DIR dapat digunakan untuk mengubah direktori ini. Setelah direktori diubah, skrip tidak akan menuliskannya secara otomatis ke konfigurasi shell dan terminal akan memberi tahu bahwa direktori tersebut tidak ada di PATH. Tambahkan direktori itu ke PATH atau jalankan program menggunakan path lengkap.

Saat digunakan untuk pertama kali, goose akan meminta Anda mengonfigurasi Provider. Anda dapat melewati provider bawaan terlebih dahulu, lalu menambahkan Provider kustom sesuai bagian berikutnya. Di terminal, buka direktori tempat Anda ingin bekerja lalu jalankan:

goose session

Mendapatkan parameter koneksi dari OmniProxy

Siapkan alamat, kunci, dan nama model dari OmniProxy Anda sendiri. Contoh resmi untuk Provider kustom menggunakan base_url yang berakhir dengan /v1/chat/completions, sehingga panduan ini menggunakan format yang sama:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   salin dari daftar model OmniProxy saat ini; pisahkan beberapa model dengan koma

Salin nama model secara lengkap dari daftar OmniProxy saat ini, termasuk karakter garis miring. Pada 2026-10-09, dua ID pembanding dalam dokumentasi provider adalah grok-4.7 dari Grok dan gpt-6-luna dari dokumentasi OpenAI. gpt-6-luna mendukung Chat Completions. Dalam Chat Completions, pemanggilan fungsi hanya didukung saat reasoning_effort bernilai none. Jangan menyalin nama yang tidak tersedia dalam daftar.

Mengisi konfigurasi alat

Provider kustom menggunakan format yang kompatibel dengan OpenAI, Anthropic, atau Ollama. Format kompatibel berarti alat mengirim permintaan sesuai suatu antarmuka umum. Saat menghubungkan OmniProxy, pilih OpenAI Compatible.

Versi desktop

1. Klik tombol di kiri atas untuk membuka bilah samping.
2. Klik Settings.
3. Klik Models.
4. Klik Configure providers.
5. Klik Add Custom Provider di bagian bawah jendela.
6. Untuk Provider Type, pilih OpenAI Compatible. Display Name dapat diisi dengan OmniProxy. Isi API URL dengan alamat dari bagian sebelumnya. Jika kunci diperlukan, centang opsi yang mewajibkan API Key lalu masukkan kunci OmniProxy. Isi Available Models dengan nama model dan pisahkan beberapa nama menggunakan koma.
7. Klik Create Provider.

Saat ini, versi desktop tidak dapat menentukan header permintaan kustom melalui jendela tersebut. Jika header permintaan diperlukan, ubah file konfigurasi setelah Provider dibuat.

Terminal

Jalankan:

goose configure

Pilih Custom Providers, lalu pilih Add A Custom Provider. Untuk API Type, pilih OpenAI Compatible, kemudian ikuti petunjuk untuk mengisi nama, API URL, apakah kunci diperlukan, nama model, dan apakah respons streaming didukung.

Saat melakukan konfigurasi manual di Windows, jika keyring mengalami kesalahan, petunjuk instalasinya adalah memilih untuk tidak menyimpan kunci saat ditanya apakah kunci akan disimpan ke keyring, lalu gunakan variabel lingkungan. Setelah itu, jalankan kembali goose configure. Keyring adalah penyimpanan aman berukuran kecil yang digunakan sistem untuk menyimpan kunci.

File konfigurasi

Direktori yang ditentukan adalah:

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

File dapat dibuat mengikuti contoh berikut. Ganti nama, alamat, dan model dengan milik Anda. Simpan kunci dalam variabel lingkungan yang ditentukan oleh api_key_env; jangan menuliskan kunci asli langsung di dalam file:

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

Untuk context_limit, pertahankan sebuah nilai numerik seperti pada contoh. Batas konteks sebenarnya bergantung pada model dan OmniProxy. Jangan menganggap angka dalam contoh ini sebagai batas resmi model tersebut. Sebelum menggunakannya, jalankan:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Setelah masuk ke direktori kerja, jalankan:

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

Ganti nilai --model dengan ID lengkap dari daftar. goose session tidak memiliki subperintah start. --provider dan --model juga dapat ditentukan melalui variabel lingkungan GOOSE_PROVIDER dan GOOSE_MODEL. Meskipun gateway tidak memvalidasi kunci, OMNIPROXY_API_KEY tetap harus memiliki nilai. Nilainya dapat berupa rangkaian karakter placeholder yang hanya digunakan secara lokal. Pada 2026-10-09, konfigurasi ini berhasil membaca file.

Jendela

Pengaturan

• Pengaturan di bilah samping
• Halaman Model
• Tambahkan Penyedia Kustom

Terminal

goose configure

• Pilih Penyedia Kustom
• Lalu pilih tambahkan
• Pilih jenis Kompatibel dengan OpenAI

File

custom_providers

• Di macOS dan Linux, lokasinya di ~/.config
• Di Windows, lokasinya di APPDATA
• Atur base_url sesuai contoh resmi

Memverifikasi tugas nyata

Masuk ke direktori yang berisi file biasa, lalu jalankan goose session seperti pada bagian sebelumnya. Minta goose membaca baris pertama dari file yang Anda tentukan. goose harus menampilkan isi file, bukan sekadar menyatakan bahwa konfigurasi telah disimpan.

Untuk membaca file atau menjalankan perintah, sesi memerlukan ekstensi Developer. Ekstensi Developer dapat dipahami sebagai modul alat yang memungkinkan goose menangani file dan perintah lokal. Konfigurasi default biasanya sudah menyertakannya. Jika goose menjawab bahwa alat untuk mengakses file tidak tersedia, tambahkan opsi berikut ke perintah:

--with-builtin developer

Jangan menambahkan --no-profile secara bersamaan karena parameter tersebut akan menonaktifkan ekstensi default.

Pada 2026-10-09, goose 1.54.0 berhasil membaca baris pertama dari file yang ditentukan. Respons pertama mungkin memerlukan waktu sekitar satu menit.

Setelah itu, periksa sumber dan nama model dalam catatan pemanggilan OmniProxy.

Mulai

Dapat masuk ke sesi

• goose session
• Provider adalah yang baru ditambahkan
• Nama model ada dalam daftar

Tugas

Tugas benar-benar dijalankan

• Misalnya, menampilkan isi direktori saat ini
• Periksa balasannya
• Jangan hanya memeriksa apakah penyimpanan berhasil

Catatan

Terlihat di gateway

• Gunakan alamat sesuai contoh dokumentasi
• Jangan simpan kunci di repositori
• ID model sesuai dengan daftar

Kesalahan umum

• Perintah goose tidak ditemukan: tambahkan direktori instalasi ke PATH sesuai petunjuk instalasi, lalu buka ulang terminal.
• Tidak ada jendela pada versi desktop di M3: periksa izin baca dan tulis untuk ~/.config.
• Keyring gagal: jangan simpan kunci ke keyring; gunakan variabel lingkungan.
• Model tidak ada dalam daftar: pada versi desktop, Anda dapat memilih Use custom model untuk memasukkan nama model secara manual. goose configure tidak dapat menerima nama model kustom. Untuk terminal, gunakan versi desktop atau ubah langsung GOOSE_MODEL dalam konfigurasi.
• Alamat tidak dapat dihubungi: pastikan API URL berakhir dengan /v1/chat/completions seperti pada contoh dan OmniProxy sedang berjalan.
• goose mengatakan tidak dapat membaca file: tambahkan ekstensi Developer dan jangan gunakan --no-profile.
• Mengembalikan unsupported Responses role: system: alamat biasanya sudah benar. Ganti dengan ID lengkap lain dari daftar model.

Referensi resmi

Untuk instalasi, lihat Install goose. Untuk Provider kustom, lihat goose providers. ID model yang digunakan sebagai contoh tersedia di halaman model xAI dan GPT-6 Luna.

Ganti setiap placeholder dengan nilai dari konfigurasi OmniProxy Anda sendiri. Jangan pernah menerbitkan kunci asli.

Hasil tersimpan atau HTTP 200 saja tidak membuktikan kompatibilitas Agen penuh. Periksa sumber dan model dalam catatan panggilan OmniProxy.

Sumber resmi · goose ↗