Bilgi Tabanı Bölümleri ▾

Navigasyon

▸ Buradan başlayın Rol bazlı

Kategoriler

Araçlar 52
Sözlük 12

Araçlar

Pi + JoinGonka Gateway — ucuz çıkarım üzerinde terminal ajanı

Pi, 2026'nın en hızlı büyüyen açık kaynaklı harness'larından biri olan minimalist bir terminal coding-agent'ıdır. İçindeki sağlayıcılar ~/.pi/agent/models.json dosyasında bildirimsel olarak tanımlanır ve OpenAI Completions veya Anthropic Messages konuşan herhangi bir endpoint kullanılabilir; bu da JoinGonka Gateway'in her iki yolla da bağlanabileceği anlamına gelir. Merkeziyetsiz Gonka ağı modelleri, satıcıların GPU fiyatlarından yüzlerce kat daha ucuzdur ve başlangıçtaki 3M token ücretsizdir.

Pi, npm aracılığıyla kurulur: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Paket ismi yenilenmiştir: Proje earendil-works/pi deposuna taşınmıştır ve eski @mariozechner/pi-coding-agent paketi artık güncellenmemekte olup kullanımdan kaldırılmıştır. Eğer Pi sisteminizde eski isimle kuruluysa yeniden yükleyin; ayarlar dizini ~/.pi/agent taşınma sırasında aynı kalmıştır.

Hızlı yol: yükleyici

En kısa yol yükleyicimizi kullanmaktır:

npx @joingonka/setup --tool pi

Bu yükleyici, güncel ağ modellerini içeren sağlayıcıyı ~/.pi/agent/models.json dosyasına yazar, ~/.pi/agent/settings.json dosyasında varsayılan bir model ayarlar (sizin manuel olarak seçtiğiniz modele müdahale etmez; bunu yalnızca --model minimax|deepseek|glm bayrağı değiştirir) ve canlı bir istek ile ağ geçidinin anahtarı ve modeli kabul ettiğini doğrular. Ayarlar dizini PI_CODING_AGENT_DIR değişkeni ile taşınmışsa, yükleyici oraya yazar. Anahtar, konfigürasyon dosyasına 0600 izinleriyle değişmez değer (literal) olarak kaydedilir; ortam değişkenini dışa aktarmanıza gerek yoktur.

Manuel yapılandırma: models.json içinde sağlayıcı

Kayıt olurken jg-… anahtarınızı alın ve sağlayıcıyı ~/.pi/agent/models.json dosyasına ekleyin:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeyjg-… anahtarınız düz metin olarak. Pi, $VAR/${VAR} referanslarını ve !command yapısını da anlar, ancak düz metin, dışa aktarılmış bir değişken olmadan çalışır – dosyayı 0600 izinleriyle saklayın
modelsdizi: id, name, contextWindow, maxTokens

Ağdaki modeller için doğru değerler: 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. Pi'nin varsayılanları (128000/16384) ağın gerçek limitleriyle örtüşmez, bu nedenle her iki alanı da açıkça belirtin. Varsayılan model BAŞKA bir dosyada bulunur – ~/.pi/agent/settings.json, defaultProvider ve defaultModel alanları. Kontrol: pi --list-models eklenen modelleri göstermelidir.

Alternatif olarak Anthropic yolu

Ağ geçidi Anthropic Messages de sunar: api: "anthropic-messages" ve baseUrl: "https://gate.joingonka.ai" ile bir sağlayıcı — /v1/messages yolu olmadan, istemci bunu kendisi tamamlayacaktır. Günlük kullanım için OpenAI yolu yeterlidir; Anthropic seçeneği, Pi eklentileriniz Messages formatına göre uyarlanmışsa faydalıdır.

Güvenlik uyarısı

Pi'nin varsayılan olarak tam bir izin katmanı yoktur: ajan, daha ağır harness'larda bulunan adım adım onaylar olmadan terminalde komutları yürütür. Özellikle otonom çok adımlı görevlerde, onu bir kum havuzunda (sandbox) — konteynerde veya ayrı bir kullanıcı hesabında — çalıştırın. Bu, ağ geçidinin değil, Pi'nin kendi özelliğidir.

Hangi model seçilmeli ve maliyet nedir

Ağın her üç modeli de tool calling ve streaming desteklemektedir. Uzun oturumlar ve büyük repolar için — DeepSeek V4 Flash (ağın en uzun bağlamlarından biri ve 32768'e kadar çıktı). MiniMax M2.7 evrensel bir seçenektir, GLM-5.3 Flash ise ağın en uzun bağlamına (390K) sahip reasoning modelidir: Cevap vermeden önce muhakeme yapar, bu nedenle maxTokens değerini çok düşürmeyin. Tarife tektir, canlı fiyatlar ağ geçidi fiyat listesinde mevcuttur.

Eğer Pi'nin minimalizmi yetmiyorsa, onun çatalına (fork) omp (Oh My Pi) göz atın: aynı deklaratif sağlayıcı fikri, ancak model rolleri, dil sunucuları ve alt ajanlarla birlikte. Konfigürasyon dosyaları farklıdır, bu yüzden omp ayrı olarak ayarlanır.

Pi, ~/.pi/agent/models.json dosyasına yapılacak tek bir kayıt ile JoinGonka Gateway'e bağlanır: baseUrl gate.joingonka.ai/v1, api openai-completions, anahtar düz metin olarak, doğru contextWindow/maxTokens değerlerine sahip modeller. Daha da hızlısı: npx @joingonka/setup --tool pi. Ajanı sandbox'ta çalıştırın ve ücretsiz başlangıç token'larıyla başlayın.

Daha fazla bilgi edinmek ister misiniz?

Diğer bölümleri keşfedin veya şimdi GNK kazanmaya başlayın.

Ücretsiz token al →