Bagian Basis Pengetahuan ▾

Navigasi

▸ Mulai di sini Berdasarkan peran

Kategori

Alat 52
Glosarium 12

Alat

Pi + JoinGonka Gateway — agen terminal dengan inferensi murah

Pi adalah agen coding terminal minimalis, salah satu harness open-source dengan pertumbuhan tercepat di tahun 2026. Penyedia di dalamnya dideskripsikan secara deklaratif di ~/.pi/agent/models.json, dan endpoint apa pun yang menggunakan OpenAI Completions atau Anthropic Messages dapat digunakan — artinya JoinGonka Gateway dapat terhubung melalui kedua cara tersebut. Model dari jaringan terdesentralisasi Gonka ratusan kali lebih murah daripada harga yang dipatok vendor, dan 3M token awal diberikan secara gratis.

Pi sendiri diinstal melalui npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Nama paketnya baru: proyek telah berpindah ke repositori earendil-works/pi, dan paket lama @mariozechner/pi-coding-agent dinyatakan usang dan tidak lagi diperbarui. Jika Pi terinstal dengan nama lama, silakan instal ulang; direktori pengaturan ~/.pi/agent tetap sama saat proses migrasi.

Jalur cepat: installer

Cara tercepat adalah menggunakan installer kami:

npx @joingonka/setup --tool pi

Installer ini akan mengatur penyedia dengan model jaringan terbaru di ~/.pi/agent/models.json, menetapkan model default di ~/.pi/agent/settings.json (installer tidak akan mengubah model yang sudah Anda pilih sendiri — model hanya berubah dengan flag eksplisit --model minimax|deepseek|glm), dan melakukan pengecekan langsung untuk memastikan gateway menerima kunci dan model tersebut. Jika direktori pengaturan dipindahkan menggunakan variabel PI_CODING_AGENT_DIR, installer akan menulis ke lokasi tersebut. Kunci diletakkan sebagai literal di dalam file konfigurasi dengan hak akses 0600 — Anda tidak perlu mengekspor variabel lingkungan.

Pengaturan manual: provider di models.json

Dapatkan kunci jg-… saat mendaftar lalu tambahkan penyedia di ~/.pi/agent/models.json:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeykunci jg-… Anda sebagai literal. Pi juga memahami referensi $VAR/${VAR} dan !command, tetapi literal tetap berfungsi tanpa variabel yang diekspor — simpan file dengan izin 0600
modelsarray: id, name, contextWindow, maxTokens

Nilai yang benar untuk model di jaringan ini: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000, maxTokens 32768; MiniMaxAI/MiniMax-M2.7 — contextWindow 200000, maxTokens 8192; zai-org/GLM-5.3-Flash — contextWindow 390000, maxTokens 8192. Nilai default Pi (128000/16384) tidak cocok dengan batas nyata jaringan, jadi tentukan kedua kolom itu secara eksplisit. Model default berada di file LAIN — ~/.pi/agent/settings.json, kolom defaultProvider dan defaultModel. Verifikasi: pi --list-models harus menampilkan model yang telah ditambahkan.

Jalur Anthropic sebagai alternatif

Gateway juga menyediakan Anthropic Messages: provider dengan api: "anthropic-messages" dan baseUrl: "https://gate.joingonka.ai" — tanpa path /v1/messages, klien akan menambahkannya sendiri. Untuk pekerjaan sehari-hari, jalur OpenAI sudah cukup; opsi Anthropic berguna jika ekstensi Pi Anda dirancang untuk format Messages.

Catatan tentang keamanan

Secara default Pi tidak memiliki layer izin penuh: agen mengeksekusi perintah di terminal tanpa konfirmasi langkah demi langkah yang ada pada harness yang lebih berat. Jalankan di dalam sandbox — kontainer atau akun terpisah — terutama pada tugas multi-langkah otonom. Ini adalah sifat dari Pi itu sendiri, bukan gateway.

Model mana yang dipilih dan bagaimana biayanya

Ketiga model jaringan mendukung tool calling dan streaming. Untuk sesi panjang dan repositori besar, gunakan DeepSeek V4 Flash (salah satu konteks terpanjang di jaringan dengan output hingga 32768). MiniMax M2.7 adalah opsi serbaguna, GLM-5.3 Flash adalah model reasoning dengan konteks terpanjang di jaringan (390K): model ini melakukan penalaran sebelum menjawab, jadi jangan menurunkan batas maxTokens-nya. Tarifnya seragam, harga real-time ada di daftar harga gateway.

Jika minimalisme Pi dirasa kurang, lihat fork-nya omp (Oh My Pi): ide penyedia deklaratif yang sama, tetapi dengan peran model, server bahasa, dan sub-agen. Konfigurasinya berbeda, jadi omp disetel secara terpisah.

Pi terhubung ke JoinGonka Gateway dengan satu entri di ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1, api openai-completions, kunci literal, model dengan contextWindow/maxTokens yang jujur. Lebih cepat lagi — npx @joingonka/setup --tool pi. Jalankan agen di sandbox dan mulai dengan token gratis awal.

Ingin tahu lebih banyak?

Jelajahi bagian lain atau mulai hasilkan GNK sekarang.

Dapatkan token gratis →