Autonomous Coding Agent (Built from Scratch)
Bu proje, herhangi bir hazır framework (LangChain, CrewAI vb.) kullanılmadan, tamamen Python ve Google Gemini Flash API kullanılarak sıfırdan (from scratch) geliştirilmiş bir otonom kodlama ajanıdır.
Standart LLM'lerin aksine, bu ajan sadece kod üretmez; ürettiği kodu yerel ortamda çalıştırır, hataları analiz eder ve kendi kendini düzelterek (Self-Correction) görevi tamamlar.
agentic_ai.mp4
- Otonom Döngü (Autonomous Loop): Kod yazma, çalıştırma ve test etme süreçlerini insan müdahalesi olmadan yönetir.
- Hata Düzeltme (Self-Correction): Çalışan kod hata verirse (Runtime Error), ajan
stderrçıktısını okur, hatanın nedenini anlar ve kodu revize eder. - Function Calling Mimarisi: Modelin yapılandırılmış verilerle sistem komutlarını ve dosya işlemlerini yönetmesini sağlar.
- Güvenli Çalıştırma (Safe Execution): Kodlar izole edilmiş alt süreçlerde (
subprocess) çalıştırılır. - Yerel Dosya Entegrasyonu: Proje dizinindeki dosyaları okuyabilir, analiz edebilir ve güncelleyebilir.
Ajan, kendisine verilen bir görevi yerine getirmek için aşağıdaki döngüyü izler:
- Analiz: Kullanıcı isteğini ve proje bağlamını (dosyalar) anlar.
- Planlama & Kodlama: Gemini Flash API üzerinden gerekli Python kodunu oluşturur.
- Çalıştırma (Execution): Oluşturulan kodu sistemde çalıştırır.
- Doğrulama (Verification):
- Başarılı: Sonucu kullanıcıya sunar.
- Hata: Hata mesajını analiz eder, çözüm üretir ve 2. adıma geri döner (Iteration).
Projeyi yerel makinenizde çalıştırmak için adımları izleyin:
-
Repoyu klonlayın:
git clone [https://github.com/KULLANICI_ADIN/repo-adi.git](https://github.com/KULLANICI_ADIN/repo-adi.git) cd repo-adi -
Gerekli paketleri yükleyin: Öneri:
uvveyavenvkullanarak sanal ortam oluşturun.pip install -r requirements.txt
-
API Anahtarını Ayarlayın:
.envdosyası oluşturun ve Google Gemini API anahtarınızı ekleyin:GEMINI_API_KEY=api_anahtariniz
Ajanı başlatmak için main.py dosyasını çalıştırın:
uv run main.py args