Bir yatırım şirketini AI ajanlarla kuran açık kaynak proje: TradingAgents. Ama bu bir al-sat botu değil, araştırma aracı
TradingAgents, gerçek bir yatırım şirketinin işleyişini yapay zeka ajanlarıyla taklit eden ücretsiz bir framework. Bir ticker giriyorsun; dört analist şirketi farklı açılardan inceliyor, bir boğa ve bir ayı araştırmacısı tartışıyor, trader karar veriyor, risk ekibi bunu sorguluyor ve portföy yöneticisi son sözü söylüyor. Her kararı bir hafıza dosyasına yazıyor ve aynı hisseye bir sonraki bakışında gerçekte ne olduğunu kontrol edip bundan ders çıkarıyor. Aşağıda organizasyonun nasıl çalıştığı, kurulum, Borsa İstanbul hisseleriyle nasıl denenir ve kullanmadan önce bilmen gereken sınırlar var.
Projenin kendisi
Repo Apache 2.0 lisanslı, tamamen ücretsiz ve GitHub'da 100 binden fazla yıldızı var. Arkasında bir arXiv makalesi de duruyor. Doğrudan gitmek istersen düğme repoyu açıyor.
Aşağıda fazladan olan şey şu: ajanların hangi sırayla ne yaptığı, Windows'ta kurulumu bozan iki küçük fark, Türk hisseleriyle çalıştırırken temel analizin neden eksik kalabileceği ve "kendini puanlıyor" kısmının gerçekte nasıl işlediği.
Organizasyon nasıl çalışıyor
Fikir şu: tek bir modele "bu hisseyi al mı sat mı" diye sormak yerine, işi gerçek bir şirketteki gibi rollere bölmek. Her ajan kendi işine odaklanıyor, kararı tek bir model değil bir süreç veriyor.
Bir ticker girdiğinde olan şey
- 1
Dört analist
Temel analiz, haber ve makro, sentiment (StockTwits, Reddit), teknik göstergeler. Aynı anda çalışıyorlar
- 2
Boğa ve ayı tartışması
İki araştırmacı raporları okuyup karşılıklı tartışıyor: kazanç potansiyeli ve riskler
- 3
Trader
Tüm raporlardan bir işlem önerisi çıkarıyor: zamanlama ve büyüklük
- 4
Risk ekibi
Volatilite ve likiditeye bakıp öneriyi sorguluyor, değiştiriyor
- 5
Portföy yöneticisi
Onaylıyor ya da reddediyor. Onaylanırsa emir simüle borsaya gidiyor
Son adımdaki kelime önemli: simüle borsa. TradingAgents senin aracı kurumuna bağlanmıyor, gerçek emir vermiyor. Çıktısı bir karar ve onu destekleyen raporlar.
Kurulum
Python 3.11 ya da daha yenisi gerekiyor. Repoyu klonla, bir sanal ortam aç ve paketi kur.
git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents
python3 -m venv .venv
source .venv/bin/activate
pip install .git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install .Sonra API anahtarını ver. README export komutlarıyla anlatıyor ama export PowerShell'de çalışmaz; en sorunsuz yol .env dosyası, her işletim sisteminde aynı.
cp .env.example .env
# Windows'ta: copy .env.example .env
# Sonra .env'i aç, kullandığın sağlayıcının satırını doldur:
# ANTHROPIC_API_KEY=... ya da OPENAI_API_KEY=...tradingagentsAçılan ekranda ticker'ı, analiz tarihini, LLM sağlayıcısını ve araştırma derinliğini seçiyorsun; ajanların ilerleyişini canlı izliyorsun. Docker'ı tercih edersen repo onu da destekliyor: .env'i doldurduktan sonra docker compose run --rm tradingagents.
Kurulumda takılınan yerler
Windows'ta source .venv/bin/activate yazmak.
Windows'ta klasör adı farklı: .venv\Scripts\Activate.ps1. Script çalıştırma engeli çıkarsa PowerShell'de bir kere Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
Sadece Claude anahtarı girip varsayılan modellerle devam etmek.
Varsayılan modeller OpenAI'ın. Elindeki anahtar hangi sağlayıcınınsa CLI'da onu seç; Claude, Gemini, DeepSeek, OpenRouter ve yerel Ollama da destekleniyor.
Türk hisseleriyle denemek
Fiyat verisi Yahoo Finance'ten geliyor ve proje Yahoo'nun kapsadığı her borsayı borsa ekiyle kabul ediyor. Borsa İstanbul hisseleri Yahoo'da .IS ekiyle duruyor, yani THYAO.IS ya da ASELS.IS gibi yazıyorsun. Kripto için BTC-USD.
Geçmiş tarihli analizde temel veri eksik kalır
ABD şirketlerinin mali tabloları SEC EDGAR'dan, o gün kamuya açık olan haliyle geliyor. ABD dışı şirketlerde ise Yahoo kullanılıyor ve Yahoo bir rakamın ne zaman yayınlandığını söyleyemediği için, geçmiş bir tarihle çalıştırırsan temel analistine bu tablolar verilmiyor. Bugünün tarihiyle çalıştırınca sorun yok. Yani THYAO.IS'i geçen yılın bir gününe göre analiz ettirirsen temel analiz kısmı zayıf kalır; bu bir hata değil, geleceği görmesini engelleyen bilinçli bir tercih.
"Kendini puanlıyor" kısmı gerçekte nasıl çalışıyor
Hafıza her zaman açık. Biten her analiz kararını ~/.tradingagents/memory/trading_memory.md dosyasına ekliyor. Aynı hisseyi bir sonraki çalıştırışında önceki kararın gerçekleşen getirisine bakıyor, hem düz getiriye hem de o borsanın endeksine göre farka, bir paragraflık bir değerlendirme yazıyor ve bunu son kararlarla birlikte portföy yöneticisinin önüne koyuyor.
Yani öğrenme model eğitmek değil: geçmiş kararları ve sonuçlarını bir sonraki prompta not olarak eklemek. İşe yarıyor ama sadece aynı hisseye zaman içinde tekrar baktığında. Bugün tek bir analiz yaptırırsan hafızadan bir şey kazanmazsın.
Sistemin gerçekten iyi karar verip vermediğini görmek istersen backtest komutu var: aynı süreci bir tarih aralığında birden çok hisse için çalıştırıp her kararı sonradan gerçekleşen getiriye göre puanlıyor. Kendi hafıza dosyana dokunmuyor.
tradingagents backtest NVDA,AAPL --start 2026-06-01 --end 2026-08-01 --every 7Kullanmadan önce
Proje kendini açıkça bir araştırma aracı olarak tanımlıyor ve yatırım tavsiyesi olmadığını yazıyor. Aynı hisse ve tarihle iki çalıştırma farklı karar verebilir, çünkü modeller her seferinde farklı düşünüyor ve haber, sosyal medya verisi zamanla değişiyor. Ayrıca her analiz bir düzine ajanın çok sayıda model çağrısı demek; API faturası tek bir sohbetten çok daha hızlı büyür. İlk denemede araştırma derinliğini düşük tut.
DOA: Yapay Zeka ve Otomasyon
Buradaki araçları tek başına kurmak bir şey, onlarla gerçekten üretmeye başlamak başka bir şey. Toplulukta hem bu araçları günlük kullananlar var hem de sıfırdan sistem kuranlar.
İşinde gerçekten çalışan bir sistem kurmak istiyorsan 10 dakika konuşalım; ne yapmaya çalıştığına bakıp sana uygun yolu söyleyeyim. Ücretsiz, satış konuşması değil.
10 dakikalık görüşme alBunu tek başına değil, aynı işi yapanlarla birlikte öğrenmek istiyorsan topluluk her zaman açık:
Topluluğa katılBu bağlantı bir ortaklık (affiliate) bağlantısıdır.