OpenClaw’ın çekirdeği pi-mono’dan yola çıkıp Python’a taşınan minimal bir ajan

Bence hâlâ birçok insan için ajanlar biraz belirsiz bir varlık. Bir şekilde etkileyici görünüyorlar ama içine bakınca gerçekte nasıl çalıştıklarını kavramak zor oluyor ve nereden kurcalamaya başlamak gerektiği de çoğu zaman netleşmiyor.

Ben de benzer durumdaydım. Sonra OpenClaw’ın çekirdeğinin pi-mono olduğunu duydum ve bunun son derece minimal bir ajan olması beni etkiledi. Özellikle de bunun, "en güçlü şey basit sistemdir" felsefesini çok iyi temsil eden bir örnek gibi geldiğini düşündüm. Bu yüzden bunu kendi ajanımı yapmak için bir başlangıç noktası olarak alıp, en azından otomatik olarak kod yazabilecek seviyeye kadar Python’a taşımayı denedim.

Aslında mevcut py-pimono içinde, pi-mono’da zaten olup henüz gelmemiş çok daha fazla şey var. Örneğin şunlar:

• oturum yönetimi
• steering
• takip adımları
• çeşitli yardımcı araçlar
• streaming

Bu nedenle py-pimono, tamamlanmış bir üründen çok, gerçekten neredeyse hiçbir şeyi olmayan ama en azından çalışan, neredeyse sadece iskeleti kalmış bir ajana daha yakın. Bunun yerine yapıyı nispeten net biçimde görünür bıraktım; böylece nerelere bakmak ve nereye ne eklemek gerektiğini sezmek kolay olsun istedim. Bu yüzden ajanlar hâlâ soyut gelen kişiler için de yapıyı takip ederek üzerinde çalışmaya elverişli olacağını düşündüm. Örneğin şu gibi soruları mümkün olduğunca küçük bir kod tabanı içinde takip edilebilir hale getirmek istedim.

• Bazıları, "bir ajanın uzun soluklu biçimde çalışmayı sürdürmesi"nin kodda nasıl ifade edildiğini merak edecektir
• Bazıları da oturum verisinin nasıl kaydedilip yeniden yüklendiğini merak edecektir

Bu yüzden bu depo, bu parçaları mümkün olduğunca birbirinden ayırıyor; LLM ile birlikte kodu okuyup analiz ederken kendi döngünüzü ya da oturum yönetiminizi eklemek ve yapıyı adım adım genişletmek için iyi bir başlangıç noktası olmasını umuyorum.

Yine de hemen çalıştırıp el alışkanlığı kazanabilmek için, bu minimal harness üzerine UI’ı da birlikte ekledim. ui/ dizinini açarsanız, deneme amaçlı kullandığım çeşitli arayüzleri ve Discord bağlantısını da görebilirsiniz.

Kurulum:

pip install py-pimono  

Codex kimlik doğrulaması zaten yapılmışsa doğrudan çalıştırabilirsiniz.

pyai  

Codex kimlik doğrulaması olmasa da fallback olarak papağan gibi tekrar eden MockLlm çalıştığı için, debug noktaları koyarak ajan döngüsünü izlemek de oldukça eğlenceli.

Codex kimlik doğrulamanız henüz yoksa önce giriş yapıp sonra çalıştırabilirsiniz.

codex login  
pyai  

Bundan sonra burada gerçekten önemli olup hâlâ eksik olan parçaları mümkün olduğunca temiz ve minimal biçimde birlikte eklemek eğlenceli olabilir diye düşündüm. Ajanları belirsiz bir şey olarak bırakmak yerine, daha fazla insanın onları açıp inceleme, değiştirme ve kendine uyarlama hissini yaşamasını istediğim için bunu paylaşıyorum.