Oh My Pi Eğitimi: Grok’u Kodlama Ajanınız Olarak Kullanarak Tam Bir Uygulama Geliştirin

Neden Oh My Pi?

İyi bir kodlama ajanının iki şeye ihtiyacı vardır: güçlü bir ajansal model ve güçlü bir kodlama iskeleti (harness).

Zekâyı model sağlar. Bu eğitimde, xAI’nin kodlama, uzun süre çalışan ajanlar ve tüm kod tabanları boyunca çok adımlı işler için geliştirdiği Grok 4.6’yı kullanıyoruz. 500.000 token’lık bağlam penceresini, görsel girdi, fonksiyon çağırma, kod yürütme ve web aramayı destekler.

Ancak en iyi model bile, iskeleti yalnızca metin okuma ve yazmaya izin veriyorsa sınırlı kalır. Gerçek bir geliştirici gibi çalışabilmesi için modelin şunları yapabilmesi gerekir:

• Bir depoyu incelemek ve dosyaları güvenilir şekilde düzenlemek
• Komutları çalıştırmak ve testleri yürütmek
• Tanılama çıktısını okumak ve hataları ayıklamak
• Belgeleri aramak ve yaptığı değişikliklerin gerçekten çalıştığını doğrulamak

OMP’nin sunduğu da budur: LSP entegrasyonu, gerçek bir hata ayıklayıcı, kalıcı kod yürütme, tarayıcı ve web araçları, GitHub entegrasyonu, bellek ve paralel alt ajanlar. Modelle birlikte tam ajansal döngüyü oluştururlar:

Planla → incele → düzenle → çalıştır → hata ayıkla → test et → doğrula

Model ne yapılacağına karar verirken OMP bunu gerçekten yapması için gerekli araçları sağlar. Ve OMP 60’tan fazla yapay zekâ sağlayıcısını desteklediği için Grok’a bağlı kalmazsınız. Aynı iş akışı Grok, Claude veya başka bir modeli bağladığınızda da geçerlidir.

Oh My Pi’yi Kurun

Oh My Pi, Stencil Labs tarafından oluşturulan, açık kaynaklı Pi kodlama ajanının bir çatallamasıdır ve 34.000’den fazla GitHub yıldızıyla kısa sürede en popüler terminal kodlama ajanlarından biri haline gelmiştir. Özel bir ajan yığını kurup yapılandırmaya zaman harcamadan kullanıma hazır bir kodlama ortamı isteyen geliştiriciler için tasarlanmıştır.

OMP Linux, macOS ve Windows’ta çalışır.

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

curl -fsSL https://omp.sh/install | shAltyapı:

Windows PowerShell’de:

irm https://omp.sh/install.ps1 | iexAltyapı:

Bun’u (sürüm 1.3.14 veya üstü) kullanarak küresel olarak da kurabilirsiniz:

bun install -g @oh-my-pi/pi-coding-agentAltyapı:

Kurulumdan sonra omp komutu bulunamazsa terminalinizi yeniden başlatın veya yükleyicinin çıktısında kurulum konumunu kontrol edin.

Ardından kurulumu doğrulayın:

omp --versionAltyapı:

Örneğin:

omp/18.0.6Altyapı:

Bir sürüm numarası görünüyorsa OMP doğru kurulmuştur ve omp komutu kullanıma hazırdır.

SpaceXAI Erişimini Ayarlayın

Oh My Pi ile Grok’u kullanmak için iki seçeneğiniz vardır.

Sadece modeli test ediyor veya bu eğitimi takip ediyorsanız xAI API’sini kullanmanızı öneririm. https://console.x.ai/ adresinde bir hesap oluşturun, az miktarda ön ödemeli kredi ekleyin ve bir API anahtarı üretin. xAI kullanımı doğrudan kredi bakiyenizden düşer; bu da ne kadar harcadığınızı kontrol etmeyi kolaylaştırır.

Grok’u düzenli olarak kodlama için kullanmayı planlıyorsanız, bir SuperGrok aboneliği daha mantıklı olabilir. OMP, SpaceXAI OAuth üzerinden SuperGrok’u doğrudan destekler; böylece her API isteği için ayrı ayrı ödeme yapmak yerine /login ile aboneliğinizi bağlayabilirsiniz.

Bu eğitimde, test etmesi ve maliyeti kontrol etmesi daha kolay olduğu için API yöntemini kullanacağız.

API anahtarınızı SpaceXAI geliştirici konsolunda oluşturun ve güvenli bir şekilde saklayın. OMP, XAI_API_KEY ortam değişkenini otomatik olarak arar.

Linux veya macOS’ta:

export XAI_API_KEY="your-xai-api-key"Altyapı:

Terminalinizi yeniden başlattıktan sonra da kalıcı olması için:

echo 'export XAI_API_KEY="your-xai-api-key"' >> ~/.bashrc
source ~/.bashrcAltyapı:

Windows PowerShell’de:

$env:XAI_API_KEY="your-xai-api-key"Altyapı:

Mevcut Grok modellerini şununla kontrol edebilirsiniz:

omp models xaiAltyapı:

Oh My Pi’yi Grok ile Başlatın

Kodlama ajanını test etmek için yeni bir dizin oluşturun:

mkdir grok-pi-demo
cd grok-pi-demoAltyapı:

OMP’nin yaptığı değişiklikleri izleyebilmesi için bir Git deposu başlatın:

git initAltyapı:

Şimdi Oh My Pi’yi başlatın:

ompAltyapı:

İlk başlatmada, OMP sağlayıcılar, web arama ve arayüzü yapılandırmak için kısa bir kurulum sihirbazı açabilir. Ayrıca istediğiniz zaman omp setup çalıştırarak tekrar açabilirsiniz.

XAI_API_KEY ortam değişkenini zaten yapılandırdığımız için xAI’ye tekrar oturum açmanız gerekmez. Sağlayıcı kurulumunu bitirdiğinizde Esc’ye basın.

API kredileri yerine SuperGrok aboneliği kullanıyorsanız, oturum açma ekranından xAI Grok OAuth’u (SuperGrok veya X Premium+) seçin.

OMP açıldığında şunu girin:

/modelAltyapı:

Sağlayıcı listesinden xAI’yi seçin ve şunu tercih edin:

grok-4.6Altyapı:

Bunun yerine daha yeni Grok 4.7’yi kullanmak isterseniz burada grok-4.7 seçin. Bu eğitimdeki diğer her şey aynı kalır.

OMP, bağlam penceresi, fiyatlandırma, akıl yürütme desteği ve görsel yetenekler dahil olmak üzere yararlı model bilgilerini de gösterir.

Artık Oh My Pi içinde terminal tabanlı bir kodlama ajanı olarak Grok çalışıyor. Buradan OMP’nin yerleşik araçlarını kullanarak dosyaları inceleyebilir, kodu değiştirebilir, komutları çalıştırabilir, testleri yürütebilir, sorunları hata ayıklayabilir ve daha büyük geliştirme görevlerini tamamlayabilir.

Oh My Pi’nin Yerleşik Özelliklerini Keşfedin

Oh My Pi, 31 yerleşik araçla ve 60’tan fazla AI sağlayıcısına destekle birlikte gelir; böylece çoğu kodlama iş akışı için ek eklentiler veya MCP sunucuları kurmaya gerek kalmaz.

En yararlı yerleşik yeteneklerden bazıları şunlardır:

• Dosya yönetimi: Dosyaları okuma, oluşturma, düzenleme, arama ve yapısal olarak değiştirme.

• Terminal erişimi: Komut satırı komutları çalıştırma ve süreçleri doğrudan ajan üzerinden yönetme.

• Kod yürütme: Kalıcı Python ve JavaScript oturumları çalıştırma.

• LSP entegrasyonu: Tanımlara gitme, başvuruları bulma, sembolleri yeniden adlandırma, tanılamaları görüntüleme ve kod eylemleri uygulama.

• Hata ayıklayıcı: DAP entegrasyonlarını kullanarak Python, Go, C/C++ ve diğer desteklenen uygulamalarda hata ayıklama.

• Web arama: Belgelerde, GitHub, Stack Overflow, Reddit, paket kayıtları, araştırma makaleleri ve daha geniş web’de arama.

• Tarayıcı otomasyonu: Chromium tabanlı bir tarayıcı aracılığıyla web sitelerini açma ve etkileşim kurma.

• Alt ajanlar: Daha büyük kodlama görevlerini paralel çalışan birden fazla ajan arasında bölme.

• GitHub araçları: Depolar, sorunlar, çekme istekleri, kod arama ve GitHub Actions ile çalışma.

• Bellek: Kodlama oturumları arasında yararlı proje bilgilerini saklama ve geri çağırma.

• Görüntü anlama: Ekran görüntülerini, diyagramları ve diğer yerel görselleri inceleme.

• Görüntü oluşturma: Desteklenen AI sağlayıcılarıyla görseller üretme veya düzenleme.

• Metinden konuşmaya: xAI Grok Voice kullanarak konuşma üretme.

• Uzak dosyalar: ssh:// yolları üzerinden uzak makinelerdeki dosyaları okuma.

• Oturum yönetimi: Kontrol noktası oluşturma, geri alma, dallanma, sürdürme ve daha uzun ajan oturumlarını yönetme.

• Ajan düzenleme: İsteminizdeki orchestrate ve workflowz gibi anahtar sözcükler, karmaşık görevler için birden çok alt ajanı koordine eder.

Bunlardan bazıları—GitHub, bellek, görsel oluşturma, metinden konuşmaya ve kontrol noktaları—varsayılan olarak kapalıdır. OMP’nin ayarlarından etkinleştirebilirsiniz.

Başka bir deyişle, model yalnızca kod üretmekten çok daha fazlasını yapabilir. Oh My Pi aracılığıyla web’de arama yapabilir, bir kod tabanını anlayabilir, dosyaları düzenleyebilir, komutlar çalıştırabilir, hataları ayıklayabilir, proje bağlamını hatırlayabilir ve aynı terminal arayüzünden birden fazla ajanı koordine edebilir.

Oh My Pi ve Grok ile Bir Proje Oluşturun

Kurulumu basit bir kodlama sorusuyla test etmek yerine, ona eksiksiz bir proje verelim ve Grok ile Oh My Pi’nin planlama, uygulama, test ve yineleme adımlarını ne kadar iyi yönettiğini görelim.

Önce OMP’yi plan moduna alın (bu yazının yazıldığı tarihte /plan):

/planAltyapı:

Ardından şu istemi girin:

Build a simple Hospital Management System in Python.

Use Streamlit for the web interface and SQLite for storing data. Keep the project lightweight and easy to run locally.

The app should let hospital staff register patients, add doctors, schedule appointments, admit and discharge patients, and view available beds.

Create a dashboard showing total patients, doctors, appointments, admitted patients, and available beds.

Use a clean sidebar for navigation, simple forms and tables, and realistic sample data.

Organize the Python code properly, create the database automatically, add basic validation, and make all CRUD operations work.

Install any required dependencies, run the application, test the main workflows, and fix any errors.Altyapı:

Planı gözden geçirin

Kod yazmadan önce Grok, OMP’nin yerleşik araçlarını kullanarak ilgili belgeleri araştırdı, Streamlit ve Python ekosistemi hakkında güncel bilgileri kontrol etti, gereksinimleri inceledi ve uygulamanın nasıl yapılandırılması gerektiği konusunda akıl yürüttü.

Ardından bölümlere ayrılmış ayrıntılı bir uygulama planı üretti. OMP planı etkileşimli hale getirir; böylece bölümler arasında gezebilir, tekil kararları daha ayrıntılı inceleyebilir ve ajanın projeye dokunmasına izin vermeden önce değişiklikler yapabilirsiniz.

Memnun kaldığınızda planı onaylayın ve Grok’un inşa etmeye başlamasına izin verin.

Uygulamayı Grok’a oluşturup test ettirin

Planı onayladıktan sonra asıl uygulama şaşırtıcı derecede sorunsuz ilerledi. Grok proje yapısını, veritabanı katmanını, Streamlit arayüzünü, örnek verileri ve CRUD işlevini oluşturdu; ardından bağımlılıkları kurup uygulamayı test etti.

İlk çalışan sürümün oluşturulup test edilmesi beş dakikadan az sürdü.

İşte burada düzgün bir kodlama iskeletine sahip olmanın önemi ortaya çıkıyor. Grok sadece bir Python kod bloğu üretip bana geri vermiyordu. Dosyalar oluşturabiliyor, uygulamayı çalıştırabiliyor, hataları inceleyip düzeltmeler yapabiliyor ve proje ayağa kalkana kadar devam edebiliyordu.

Arayüz üzerinde yineleyin

İlk sürüm çalışıyordu, ancak varsayılan Streamlit görünümünü sevmedim. Çok standart bir Streamlit uygulaması gibi görünüyordu.

Bu yüzden temayı, pano düzenini, görsel hiyerarşiyi ve bilgilerin nasıl sunulacağını içeren değişiklikleri ajana söyledim. Grok, her şeyi sıfırdan yeniden inşa etmek yerine mevcut projeyi değiştirdi.

Nihai sonuç; hasta yönetimi, doktor kayıtları, randevular, kabuller, yatak takibi ve raporlamayı içeren cilalı bir Hastane Yönetim Sistemi oldu.

Bu süreç aynı zamanda kodlama ajanlarının değerini gösteriyor: Çalışan bir sürümle başlayabilir, gözden geçirip basit takip talimatlarıyla tasarım ve işlevi sürekli iyileştirebilirsiniz.

Maliyete dair bir not

Bu kurulumun tek büyük dezavantajı şudur: API üzerinden Grok, ajansal kodlama için pahalı hale gelebilir.

Bu projede SpaceXAI kullanım panosu, 938 API isteği boyunca yaklaşık 19,4 milyon token işlenerek toplam harcamanın 11,84 $ olduğunu gösterdi. Kullanımın çoğu planlama, web araması, dosya düzenleme, araç çalıştırma, uygulamayı test etme ve arayüzü iyileştirmeden kaynaklandı.

Ara sıra test için API kredileri hâlâ kullanışlıdır; çünkü ne kadar harcadığınızı tam olarak kontrol edebilirsiniz. Ancak her gün kod yazıyor veya daha büyük projeler geliştiriyorsanız, özellikle ajansal iş akışlarının tek bir oturumda yüzlerce istek ürettiği durumlarda, SuperGrok aboneliği muhtemelen daha iyi bir seçenektir.

Grok mükemmel sonuçlar verdi; ancak bu test, kodlama ajanlarında maliyet ve token kullanımının, model kalitesi kadar önemli olduğunu da gösterdi.

Son Düşünceler

Kodlama ajanlarıyla ilgili netleşen bir şey var: Model ve kodlama iskeletinin aynı şirketten gelmesi gerekmiyor. Bir modelin varsayılan iskeleti her zaman onu kullanmanın en iyi yolu değildir ve geliştiriciler giderek daha fazla Claude veya Grok gibi güçlü modelleri, iş akışlarına daha iyi uyan alternatif kodlama ajanları ve terminal tabanlı araçlarla eşleştiriyor.

Sorun şu ki, kendi kurulumunuzu oluşturmak hızla yorucu hale gelebilir. MCP sunucuları kurmaya, beceriler eklemeye, eklentileri yapılandırmaya, araçları bağlamaya ve her şeyi kendiniz yönetmeye başlarsınız.

Oh My Pi’de hoşuma giden de bu. Çoğu yeteneği yerleşik olan, pilleri dahil bir kodlama ajanı. Kurarsınız, sağlayıcınızı veya aboneliğinizi bağlarsınız, bir model seçersiniz ve kodlamaya başlarsınız. Ajanı gerçekten kullanmaya başlamadan önce saatlerinizi onu bir araya getirmekle harcamanız gerekmez.

Grok, OMP ile çok iyi çalıştı ve sağlam bir uygulama üretti; ancak API maliyeti beklediğimden yüksekti. Ara sıra test için API kredileri uygun. Her gün Grok ile kodluyor olsaydım, şahsen OMP ile SuperGrok’a bakardım.

Sonuçta ilginç olan yalnızca hangi şirketin en iyi kodlama modeline sahip olduğu değil. Asıl ilginç olan, gerçekten nasıl çalıştığınıza en uygun model ve iskelet kombinasyonunu bulmaktır.