Pi Kurulumu ve OmniProxy Yapılandırması

Pi, doğrudan komut satırında sizinle konuşan, dosyaları okuyan ve görevleri tamamlayan küçük bir terminal asistanıdır. Sistem istemi kısadır ve varsayılan olarak az sayıda araç sunar. Başka komutlara, iş akışlarına veya arayüzlere ihtiyaç duyduğunuzda bunları uzantılar aracılığıyla ekleyebilirsiniz. Uzantılar, Pi’ye yeni yetenekler kazandıran bileşenler olarak düşünülebilir ve hazırlandıktan sonra başkalarıyla da paylaşılabilir.

Alt ajanlar, görevin bir bölümünü başka bir asistana devreder. Planlama modu ise uygulamaya başlamadan önce adımları düzenler. Bu iki özellik varsayılan olarak sunulmaz; Pi’den bunları oluşturmasını isteyebilir veya başkalarının paylaştığı paketleri kurabilirsiniz.

Kurulum öncesi hazırlık

macOS ve Linux’ta, indirme ve kurulumu otomatik olarak tamamlayan tek bir komut olan kurulum betiği kullanılır. Windows’ta Pi ana sayfasında verilen PowerShell komutu kullanılır; PowerShell, Windows ile birlikte gelen bir komut satırı ortamıdır. Pi’yi Windows içindeki Linux ortamı olan WSL’ye de kurabilirsiniz.

npm ile kurulum yapacaksanız önce Node.js 22.19 veya daha yeni bir sürümü hazırlamanız gerekir. npm, Node.js ile kullanılan ve Pi’yi komut satırından kurabilen bir paket yöneticisidir.

macOS Linux

install.sh

• Resmi betiği curl ile alın
• Bağımlılık sürümleri kurucu tarafından sabitlenir
• Güncellemek için pi update kullanın

Windows

install.ps1

• Resmi PowerShell komutu
• Git for Windows, Bash sağlar
• WSL de kullanılabilir

Node zaten varsa

npm

• Node 22.19+ gerekir
• Paket adı pi-coding-agent
• --ignore-scripts ekleyin

Kurulum ve ilk çalıştırma

macOS veya Linux’ta terminali açıp şu komutu çalıştırın:

curl -fsSL https://pi.dev/install.sh | sh

Windows’ta PowerShell’i açıp şu komutu çalıştırın:

powershell -c "irm https://pi.dev/install.ps1 | iex"

Node.js 22.19 veya daha yeni bir sürüm zaten kuruluysa Quickstart’taki alternatif komutu da kullanabilirsiniz:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Kurulum betiği etkileşimli bir terminalde durup sorular sorabilir; ekrandaki yönlendirmeleri izleyerek devam edin. Gerekli Node sürümü zaten kuruluysa bu npm komutu soru sormaz. Başka bir dizine kurmak için --prefix /dizininiz ekleyin. 2026-10-09 tarihinde bu yöntemle Pi 1.1.0 kuruldu.

Normal npm kurulumu, bağımlılıkların yaşam döngüsü betiklerine, yani paketlerin kurulum sırasında otomatik olarak çalıştırdığı betiklere ihtiyaç duymaz. Kurulum betiği bağımlılık sürümlerini sabitler; daha sonra pi update ile güncelleme yapılır. npm kurulumunun güncelleme yöntemi kullandığınız paket yöneticisine bağlıdır. Nix kullanıcıları Pi’yi flake üzerinden kurmalıdır. Flake, Nix’in yazılımı ve bağımlılıkları tanımlamak için kullandığı yapılandırmadır; pi update, Nix kurulumlarını güncelleyemez.

Kurulum tamamlandıktan sonra Pi’nin terminal tarafından bulunabildiğini doğrulayın:

pi --version

Windows’ta modelin Bash komutları çalıştırmasını istiyorsanız çoğu yerel kullanıcı için Git for Windows kurulması önerilir. Bash, Pi’nin bazı komutları çalıştırmak için kullandığı komut ortamıdır. Pi sırasıyla ~/.pi/agent/settings.json içindeki shellPath değerini, Program Files altındaki Git Bash’i ve PATH üzerindeki bash.exe dosyasını arar. shellPath, Bash’in konumunu belirtir; PATH ise sistemin komutları ararken kullandığı dizinlerin listesidir.

Pi’yi başlattıktan sonra kontrol etmek için !printf 'Bash is working\n' yazabilirsiniz. Dosyalarınız ve araçlarınız zaten WSL içindeyse kurulumu Quickstart’a göre bu Linux ortamında yapın.

Ardından Pi’nin incelemesini veya işlemesini istediğiniz klasöre geçip Pi’yi başlatın:

cd /path/to/folder
pi

Bu klasör, Pi’nin geçerli çalışma kapsamı olur; dosyaları ve yapılandırmaları bulmak, ayrıca oturumları gruplandırmak için kullanılır.

OmniProxy’den bağlantı değerlerini alma

Önce OmniProxy’den şu üç değeri hazırlayın:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: OmniProxy'nin mevcut model listesinden tam kimliği kopyalayın

baseUrl, Pi’nin istekleri göndereceği API adresidir ve /v1 ile bitmelidir. apiKey, API’ye erişmek için kullanılan anahtardır. Model ID, çağrılacak modelin adıdır ve OmniProxy’nin mevcut model listesinden eksiksiz olarak kopyalanmalıdır.

api alanına, uyumlu API örneğinde gösterildiği gibi openai-completions yazın. Bu alan, Pi’ye istekleri hangi API biçiminde göndereceğini bildirir.

Model ID’nin tamamını kopyalayın ve addaki eğik çizgileri koruyun. 2026-10-09 tarihinde sağlayıcı belgelerinde karşılaştırma için kullanılan iki kimlik gemini-3.8-flash ve grok-4.7 idi. Listede bulunmayan adları olduğu gibi kullanmayın.

Araç yapılandırmasını girme

Pi’nin kullanıcı düzeyindeki özel model yapılandırması models.json dosyasına yazılır. Bu dosya agent dizininde bulunur. Varsayılan dizin ~/.pi/agent, dolayısıyla tam konum ~/.pi/agent/models.json olur. PI_CODING_AGENT_DIR ortam değişkeni ayarlanmışsa Pi bunun belirttiği dizini kullanır. Ortam değişkeni, sistemin programların okuyabilmesi için sunduğu bir yapılandırma değeri olarak düşünülebilir.

Uyumlu API örneğine göre şu yapılandırmayı girin:

{
  "providers": {
    "omniproxy": {
      "baseUrl": "https://your-omniproxy-origin.example/v1",
      "api": "openai-completions",
      "apiKey": "<YOUR_OMNIPROXY_API_KEY>",
      "models": [
        { "id": "gemini-3.8-flash", "input": ["text"] },
        { "id": "grok-4.7", "input": ["text"] }
      ]
    }
  }
}

providers, bağlanan hizmetleri; models ise seçilebilecek modelleri listeler. Her modelin id değeri, OmniProxy’nin mevcut model listesindeki tam Model ID ile eşleşmelidir. input, burada metin girişinin yapılandırıldığını belirtir.

apiKey doğrudan düz metin bir değer olarak yazılabileceği gibi Pi’nin bir ortam değişkeninden okuması için $NAME veya ${NAME} biçiminde de belirtilebilir. ! ile başlayan değerler komut olarak değerlendirilir ve her istekte çalıştırılır. Gerçek anahtarı bir depoya göndermeyin. Ağ geçidi anahtarı doğrulamıyorsa yalnızca yerel makinenizde kullanılan bir yer tutucu dizesi girebilirsiniz. 2026-10-09 tarihinde dosya bu şekilde okunabildi.

/model açıldığında bu dosya yeniden yüklenir. /model, Pi içinde modelleri görüntülemek ve seçmek için kullanılan bölümdür. Özel modeller, Pi kimlik bilgilerini çözümleyebilene kadar /model içinde görünmez. Bir modeli seçtikten sonra Ctrl+S tuşlarına basarak onu yeni oturumların varsayılan modeli olarak kaydedebilirsiniz.

Dosya

models.json

• Varsayılan dizin ~/.pi/agent
• providers içine bir öğe ekleyin
• api için completions kullanın

Adres

baseUrl

• /v1 ile bitmeli
• apiKey için değişken kullanılabilir
• Model id tam olarak eşleşmeli

Seçim

/model

• Açıldığında dosya yeniden yüklenir
• Az önce eklenen modeli seçin
• Ctrl+S ile varsayılan olarak kaydedilebilir

Gerçek bir görevle doğrulama

Yapılandırma tamamlandıktan sonra dosya bulunan bir dizinde etkileşimsiz bir kontrol yapabilirsiniz. Etkileşimsiz kullanımda sürekli bir sohbet başlatılmaz; Pi bu tek görevi tamamladıktan sonra kapanır. --model sonrasındaki değeri OmniProxy’nin mevcut listesindeki tam kimlikle değiştirin:

pi -p --provider omniproxy --model gemini-3.8-flash --tools read "Belirttiğin dosyanın ilk satırını oku; dosyayı değiştirme."

Buradaki --tools read yalnızca okuma aracına izin verir; görev metni de dosyanın değiştirilmemesini açıkça ister. 2026-10-09 tarihinde Pi 1.1.0 kullanılarak dosya içeriği okundu. İlk yanıt yaklaşık iki dakika sürdü.

Etkileşimli kullanım da mümkündür: Dizine geçip pi komutunu çalıştırın, ardından /model üzerinden modeli seçin. Quickstart’taki örnek görevlerden biri, Pi’den deponun nasıl düzenlendiğini ve kontrollerin nasıl çalıştırıldığını açıklamasını istemektir. Pi’nin dosyaları okuyup bir açıklama verip vermediğini gözlemleyin; ardından OmniProxy çağrı kayıtlarında kaynağı ve model ID’yi doğrulayın.

Başlatma

pi açılabiliyor

• Önce klasöre cd ile geçin
• pi --version çıktı veriyor
• Arayüzün altında model adı var

Görev

Dizini okudu

• Deponun nasıl düzenlendiğini sorun
• Listelediği dosyaları inceleyin
• Yalnızca yapılandırmanın kaydedilmesine bakmayın

Kayıtlar

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

• Kaynak Pi
• Model ID eşleşiyor
• Anahtarı yerel makinede tutun

Yaygın hatalar

• pi bulunamıyor: Terminali yeniden açıp pi --version komutunu tekrar deneyin. npm ile kurulum yaptıysanız genel bin dizininin PATH içinde olduğunu doğrulayın.
• Özel model /model içinde görünmüyor: models.json dosyasının ~/.pi/agent/ altında olduğunu ve apiKey değerinin çözümlenebildiğini doğrulayın, ardından /model bölümünü yeniden açın.
• Windows, Bash’in bulunamadığını bildiriyor: Git for Windows kurun veya ~/.pi/agent/settings.json içinde shellPath değerini ayarlayın. JSON içindeki ters eğik çizgiler iki kez yazılmalıdır.
• İstek reddediliyor: api değerinin openai-completions olduğunu ve baseUrl değerinin /v1 ile bittiğini doğrulayın. Karşı tarafın yalnızca uyumlu olduğunu belirtmesine dayanarak ek uyumluluk seçeneklerini etkinleştirmeyin.
• Model ID geçersiz: Kimliği OmniProxy’nin mevcut listesinden yeniden kopyalayın.

Resmî kaynaklar

Kurulum komutları için Pi web sitesine ve Quickstart sayfasına bakın. Model dosyası için Choose a Model ve Configuration sayfalarına bakın. Windows komut ortamı için Run Pi on Windows sayfasına bakın. Örneklerde kullanılan model ID’leri için Gemini model listesine ve xAI model 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 · Pi ↗