Bir süredir üzerinde çalıştığım agent2win isimli açık kaynak projemi paylaşmak istiyorum.
agent2win, yapay zekâ ajanlarının Windows bilgisayarlarla iletişim kurmasını ve kullanıcının izni doğrultusunda çeşitli işlemleri gerçekleştirebilmesini sağlayan bir köprü yazılımı. Kısaca, web üzerinde çalışan bir yapay zekâ ile Windows bilgisayar arasında bağlantı kuruyor.
Örneğin ChatGPT, Claude, gemini veya kendi geliştirdiğiniz bir AI agent üzerinden agent2win’e bağlanarak;
- Ekran görüntüsü alabilir,
- Açık pencereleri ve çalışan işlemleri görebilir,
- PowerShell veya CMD komutları çalıştırabilir,
- Dosyaları okuyabilir, oluşturabilir ve düzenleyebilir,
- Klavye ve mouse kontrolü sağlayabilir,
- Uygulamaları açıp kapatabilir,
- Ses ve pano işlemlerini yönetebilir,
- Windows servislerini ve sistem bilgilerini kontrol edebilir.
agent2win, REST API ve WebSocket desteğiyle çalışıyor. İstenirse sadece yerel ağda kullanılabiliyor, istenirse Cloudflare Tunnel veya ngrok üzerinden router ayarı ve port yönlendirme gerektirmeden dışarıdan erişilebilir hâle getirilebiliyor. Ayrıca yapay zekânın bilgisayarda işlem yaparken kullanıcının onayını beklemesini sağlayan bir güvenlik katmanı da bulunuyor.
Ayrıca agent2win, ChatGPT Work gibi platformlar üzerinden bilgisayarınıza bağlantı kurarak Codex benzeri bir çalışma deneyimi sunabilir. Bu yöntem, kullanım senaryosuna göre ayrı bir API veya agent hizmeti kullanmaya kıyasla daha düşük maliyetli olabilir ve mevcut kullanım limitlerinizi daha verimli değerlendirmenize yardımcı olabilir. Özellikle dosya inceleme, kod düzenleme, komut çalıştırma ve proje kontrolü gibi işlemleri tek bir bağlantı üzerinden yönetmek mümkün hâle geliyor.
Güvenlik konusu projede özellikle dikkat ettiğim noktalardan biri. API erişimi Bearer API key ile korunuyor, riskli işlemler için masaüstü onayı alınabiliyor ve sistem tepsisine bir kapatma seçeneği ekleniyor. Public tunnel kullanılırken API key olmadan çalıştırılmaması gerekiyor. Çünkü bu yazılım, yapılandırmaya bağlı olarak bilgisayar üzerinde dosya ve sistem işlemleri gerçekleştirebildiği için herkese açık şekilde korunmasız bırakılmamalı.
Proje şu an Windows 10, Windows 11 ve Windows Server sistemleri için hazırlanıyor. Python üzerinden kurulabiliyor:
pip install agent2win
Kaynak kodu ve kullanım detaylarına GitHub sayfasından ulaşabilirsiniz:
https://github.com/harikasinkaya/agent2win
PyPI sayfası:
https://pypi.org/project/agent2win/
Projeyi geliştirirken özellikle AI agent entegrasyonları, güvenlik, sanal masaüstü kullanımı ve Windows otomasyonu tarafında geri bildirimlere açığım. Fikirlerinizi, karşılaştığınız sorunları veya eklenmesini istediğiniz özellikleri paylaşırsanız memnun olurum.
