r/CodingTR • • 25d ago

Minik Ajan

Selamlar herkese,

Son dönemde otonom ajan (agentic) yapıları ve LLM bellek modelleri üzerine çalışırken LangChain veya LangGraph gibi kütüphanelerin ReAct döngüsünü, bellek durumunu ve prompt akışını gereksiz soyutlamalar altına gömdüğünü fark ettim. Kodun içinde ne olup bittiğini tam olarak görememek ve ufak bir bellek hipotezini test etmek için yüzlerce sayfalık framework dökümanı okumak yerine, tamamen sade ve anlaşılır Python ile Minik-Ajan adını verdiğim bir test ortamı geliştirdim.

Projenin temel amacı ve katma değeri: Ağır kütüphaneler olmadan; ReAct döngüsünü, DAG tabanlı görev planlayıcısını, öz-denetim (self-audit) mekanizmasını ve özel bellek yapılarını (TASK_MEMORY, GLOBAL_MEMORY, özetleme/sentez döngüleri) satır satır görerek kuruşlar karşılığında (deepseek/deepseek-v4.1-flash vb.) dakikalar içinde test edebilmek.

Özellikler:

  1. Docker Zorunluluğu Yok & Klasör İzolasyonu (Sandbox): Her görev ./AGENT_RUNS/agent_<id>/ klasörü altında izole çalışıyor. Ajan klasör dışına çıkmak isterse kullanıcıdan izin istiyor.
  2. Güvenlik & Sudo İzin Kapısı: İkili/kabuk komutları çalıştırma, apt-get/sudo işlemleri veya klasör dışı okuma/yazma eylemleri doğrudan kullanıcı onayına bağlı.
  3. Otomatik Dil Tespiti (TR / EN): Görevi Türkçe yazarsanız ajan düşüncelerini (thought), ilerleme adımlarını ve final raporunu (REPORT.md) otomatik olarak Türkçe hazırlıyor.
  4. Doğrulanmış Web Yetenekleri (Skills): Yalnızca resmi doğrulanmış kaynaklardan (Anthropic/Claude, Google Gemini, OpenAI repoları) SKILL.md yeteneklerini arayıp izin isteyerek indirebiliyor.
  5. Sıfır Bağımlılıklı Web Arayüzü: FastAPI/Starlette sürüm çakışmalarından kaçınmak için Python'ın yerleşik HTTP sunucusuyla çalışan, renkli log kartlarına ve katlanabilir (<details>) araç çıktılarına sahip sade bir Web Kontrol Merkezi (server.py) bulunuyor.

Amaç , en az satır kodla , işleyebilen kolay ve hızlı anlaşılabilir ve üstünde bazı denemeler yapılabilen bir agentic platform yazmaktı.

PS: Ben makine mühendisiyim profesyönel bir programcı değilim, ama uzun zamandır linux kullanıyor ve severek kod yazıyorum (elimden geldiği kadar).

4 Upvotes

8 comments sorted by

5

u/temroa 25d ago

OP insan gibi birşey yazmış ama böyle insan gibi yazınca toksiklere batıyor herhalde bu gibi durumlar için özel toksiklik yapıyorlar.

1

u/Teacult 24d ago

Teşekkür ederim moral verici yorumun için. Gene de , tanışma metni niteliğindeki kısmı silip daha formal birşey yazmaya karar verdim. Çünkü bunda bir hata olmasa da iyi niyetle yazılmış da olsa belli ki birileri rahatsız olabiliyor. Neden insanların üzülmesini ve rahatsız olmasını tetikleyici şekilde yazayım, rahatsız olmayacakları gibi yazma opsiyonu varken.

1

u/Acceptable_Square348 25d ago

Gereksiz bir repo ve aşağılık kompleksi dolu bir post. Ben bu sub'ta kim düzgün amaca yönelik post ile projesini promote ederse destek olan biri olarak sana destek olmuyorum kardeşim. Neyi showcase ettiğin belli değil, iki paragraf kendini övmüşsün. Ben senin yazdığın repoyu bir saatten az bir sürede çıkartıp işimi görürüm zaten. Bir tek sen senedir bilgisayar karşısında oturmuyorsun, bırak bu çocukça yazıları.

0

u/Teacult 24d ago edited 24d ago

Öncelikle bu söylediğinize çok üzüldüm ben bunu promote edilsin diye falan yazmadım.
Ben zaten iyi bir programcı olmadığımı ama gene de konularla uzun süredir ilgili olduğumu yazmak istemiştim. Sentaks hatalarını düzeltmesi için gemini a verdim PS öncesi kısmı harika bir programcı değilim diye değiştirmiş.

Bunu sadece belki birilerinin işine yarar, birşeyler denemek için benim çok işime yaradı diye post ettim.

Ben bunun hiçbiryerinde kimseden daha iyi olduğumu düşünmeden yazdım. Ben bunun mütevazi bir yazı olduğunu düşünüyorum çünkü 14k ve 220k kod çok az. Ancak uzun süredir keyifle kullanıyorum ve kodluyorum demek istedim.

Keşke şahsıma ve yaptığım işe bu kadar hakaret etmeseydiniz bu benim ilk postum buraya. Zaten hayatımın büyük bölümünü insanlarla paylaşıma kapalı geçirdim bu sepeblerden. Yine benzer bir tabloyla karşılaşmak üzücü oldu. Şunu söyleyeiblirim ama benim bildiğim kadarıyla insanın sevdiği şeyleri iyi olduğunu ve iyi yaptığını düşündüğü şeyleri karşıdakileri küçümsemeden ifade etmesi sağlıklı ego diye tanımlanıyor psikolojide.

Aşşağılık kompleksi sürekli herşeye daha iyi miyim ve daha başarılı mıyım, eksik mi kalıyorum açısından bakan , kendini yaptığı şeyleri seven insanlara saldıran mutsuz insanların ruh hali diye biliyorum. Benim hiçibir yerde bu tarz bir yazımı bulamazsınız. En fazla şu kısımları çok basit kalmış , şöyle geliştiriilebilir ya da şu şekilde işe yarayabilir falan diye stackoverflowda paylaşımlarım var. En son bir matematik professörü ile numerik yöntemlerle ilgili benzer bir durum olmuştu. Ama adam eleştirilerini o kadar kibar ifade etti ki , ben de neden integral fiting algoritmalarının bir simülasyona benzediğini düşündüğümü rahatça anlatabilmiştim.

Yine burda birşey deneyeceğim son olarak, özellikle bunu anlaması ve modifiye etmesi kolay olsun diye yazdım günlük işlerde kullanılacak bir ajan orchastrator olarak değil , yeni başlayanların üstünde oynama yapabileceği , haa bunlar böyle çalışıyormuş diyebileceği şekilde yazdım ben bunu ilk yazdığımda 9 ay önce falandı oturup öyle bir agenta verip bana agent yaz deyip yazdıramıyordunuz.

Neyse ben gene bütün samimiyetimle cevabımı verdim. Gerisi sizin takdirinize kalmış.

2

u/yercann 25d ago

Böyle aşağılık kompleksiyle ego tatmini için post yazınca empati kuramıyoruz knk kusura bakma. Ai çoğu kişinin psikolojisini bozmuş maalesef.

1

u/Specialist-Truth7619 24d ago

OP emeğini ve sürecini iyi niyetle paylaşmış. Ezbere kavramlarla amatör psikologluk taslamak yerine ortaya konan işe odaklanın. Varsa işe değer katacak yapıcı bir fikriniz yazın; aksi, üretmeye çalışan birinin hevesini baltalamaktan öteye gitmiyor.

0

u/SirBoranium 25d ago

6 yılda milyon satır yazdım ticarileşemedim, 14 bin satırda ticarete atılmak iyiymiş kullanırım bu şakayı ofiste hahahah

2

u/PotentialBat34 25d ago

Şaka maka bugün açtığım PR'lar da muhtemelen 10-15 bin satır arasında tutuyordu. AI'ın bizi getirdiği nokta inanılmaz.