Ücretsiz AI ile Hisse Senedi Analizi: daily_stock_analysis Kurulum Rehberi

GitHub'da rastladığım açık kaynaklı bir proje olan daily_stock_analysis'i baştan sona kurup test ettim. Bu yazıda projenin ne işe yaradığını, kurulumu adım adım nasıl yaptığımı, karşılaştığım hataları ve gerçek çıktısının neye benzediğini paylaşıyorum.

daily_stock_analysis Nedir?

daily_stock_analysis, belirlediğiniz hisse senetleri için otomatik olarak fiyat verisi çeken, bu veriyi bir yapay zeka modeline (varsayılan olarak Google'ın Gemini modeli, ücretsiz olduğu için bunu kullandık siz istediğinizi kullanabilirsiniz) analiz ettiren ve sonucunda "al / sat / bekle" önerisi, giriş-çıkış fiyat seviyeleri, stop-loss ve hedef fiyat gibi bilgiler içeren bir karar raporu üreten açık kaynaklı bir araç. Rapor hem markdown dosyası olarak hem de tarayıcı üzerinden erişilebilen bir web panelinde (WebUI) görüntülenebiliyor.

Proje Çin merkezli bir geliştirici tarafından yazılmış; bu nedenle hem kod tabanında hem de arayüzde Çince ağırlıklı bir yapı var (aşağıda detaylandırıyorum).

Öne Çıkan Özellikler

Birden fazla ücretsiz veri kaynağı arasında otomatik geçiş (efinance, akshare, yfinance vb.) — biri başarısız olursa sıradaki denenir
Birden fazla AI modeli arasında otomatik yedekleme (örneğin Gemini'nin bir modeli rate-limit'e takılırsa otomatik olarak başka bir modele geçiyor)
Komut satırından tek seferlik analiz veya web arayüzünden sürekli kullanım
Bildirim entegrasyonları (e-posta, WeCom, Feishu, DingTalk, Telegram, Discord, Slack vb.)
Backtest (geriye dönük test) ve portföy takibi gibi ek modüller

Kurulum Öncesi Bilmeniz Gerekenler

Denemeden önce mutlaka bilmeniz gereken üç nokta var:

BIST hisseleri desteklenmiyor. Proje, veri kaynağı olarak Çin borsaları ve ABD borsaları (NASDAQ/NYSE) için entegrasyonlara sahip. Borsa İstanbul'da işlem gören hisseler için herhangi bir veri kaynağı bulunmuyor, dolayısıyla Türk hisseleriyle kullanamıyorsunuz. Testlerimi AAPL, NVDA, TSLA gibi ABD hisseleriyle yaptım.

Arayüz orijinalinde Çince. Projenin web arayüzü varsayılan olarak Çince ve İngilizce dilinde geliyor; birçok menü, buton ve log mesajı Çince. Ben kendi kurulumumda arayüzü Türkçeye çevirdim, ancak resmi projede bu seçenek yok — GitHub'dan indirdiğinizde Çince/İngilizce karşılaşacaksınız.

Kurulum tek tıkla değil. Bu bir "kur-çalıştır" masaüstü uygulaması değil; komut satırından Python ortamı kurmayı, bağımlılık yüklemeyi ve bir ayar dosyasını elle düzenlemeyi gerektiriyor. Temel düzeyde terminal/komut satırı bilgisi olmayan biri için zorlayıcı olabilir. Aşağıda karşılaştığım gerçek hataları da paylaşıyorum.

Adım 1: Projeyi İndirme

Önce GitHub reposunu bilgisayarınıza klonlayın:

git clone https://github.com/ZhuLinsen/daily_stock_analysis.git
cd daily_stock_analysis

Adım 2: Python Sanal Ortamı Kurma

Sistem genelindeki Python kurulumunuzu bozmamak için izole bir sanal ortam (virtual environment) oluşturmanız gerekiyor:

python -m venv venv
venv\Scripts\activate    # Windows
# source venv/bin/activate   # macOS/Linux

Bu adım kritik: sanal ortamı aktive etmeden ilerlerseniz bir sonraki adımda hata alırsınız (aşağıda detayı var).

Adım 3: Gereksinimlerin Yüklenmesi

pip install -r requirements.txt

Bu komut efinance, akshare, yfinance, litellm, fastapi, uvicorn gibi projenin ihtiyaç duyduğu tüm kütüphaneleri yüklüyor. Kurulum birkaç dakika sürebilir.

Adım 4: .env Dosyasının Yapılandırılması

Proje, ayarlarını .env adlı bir dosyadan okuyor. Önce örnek dosyayı kopyalayın:

copy .env.example .env    # Windows
# cp .env.example .env    # macOS/Linux

Hangi Hisseleri İzleyeceğinizi Belirleyin

.env dosyasını bir metin editörüyle açıp STOCK_LIST satırını kendi hisse kodlarınızla değiştirin:

STOCK_LIST=AAPL,NVDA,TSLA

Varsayılan değer Çin borsası hisse kodlarıdır (600519, 300750, 002594 gibi), bu yüzden mutlaka değiştirmeniz gerekiyor.

Ücretsiz Gemini API Anahtarı Alma

Analizi yapan yapay zeka modeli için bir API anahtarına ihtiyacınız var. Google AI Studio üzerinden ücretsiz bir Gemini API anahtarı alıp bunu .env dosyasındaki GEMINI_API_KEY satırına yapıştırın:

GEMINI_API_KEY=buraya_kendi_anahtarınız

Alternatif olarak yerel çalışan Ollama gibi bir modeli de kullanabilirsiniz, ancak ücretsiz Gemini free-tier hem kurulumu daha basit hem de ilk denemeler için yeterli.

Diğer Ayarlar

.env dosyasında ayrıca haber/arama kaynağı, bildirim kanalları (e-posta, webhook vb.) ve MARKET_REVIEW_REGION gibi başka ayarlar da bulunuyor. İlk denemeniz için bunları boş bırakabilirsiniz; sadece MARKET_REVIEW_REGION ayarını ABD hisseleri için us olarak ayarlamanız önerilir (belirtilmezse varsayılan olarak Çin verisiyle çalışmaya çalışıyor).

Adım 5: Deneme Modunda Test (--dry-run)

Her şeyin doğru kurulduğunu API'lere gerçek istek atmadan kontrol etmek için:

python main.py --dry-run --force-run

Bu komut veri kaynaklarının bağlanabildiğini doğruluyor.

Adım 6: Gerçek Analizi Çalıştırma

Test başarılıysa gerçek analizi başlatabilirsiniz:

python main.py --stocks AAPL,NVDA,TSLA --force-run

Bu, her hisse için veri çekip AI modeline analiz ettiriyor ve sonunda bir markdown raporu (report_TARIH.md) oluşturuyor.

Adım 7: Web Arayüzünü Başlatma

Sonuçları tarayıcıdan görmek için:

python main.py --webui

Ardından tarayıcınızda http://127.0.0.1:8000 adresini açarak dashboard'a ulaşabilirsiniz. Panelde her hisse için AI skoru, gerekçe, giriş-çıkış seviyeleri ve ilgili haberler listeleniyor.

Karşılaşılan Hatalar ve Çözümleri

ModuleNotFoundError: No module named 'tenacity' — Sanal ortamı aktive etmeden (venv\Scripts\activate komutunu atlayarak) python main.py çalıştırdığımda karşılaştığım hata. Çözüm: her terminal oturumunda önce sanal ortamı aktive etmek.

Market review verisinin varsayılan olarak Çin bölgesine düşmesi — .env dosyasında MARKET_REVIEW_REGION belirtilmezse sistem varsayılan olarak Çin verisiyle çalışmaya çalışıyor, bu da ABD hisseleriyle analiz yaparken gereksiz hatalara yol açıyor. Çözüm: .env dosyasına MARKET_REVIEW_REGION=us eklemek.

Ücretsiz haber/arama kaynağı (SearXNG) neredeyse hiç çalışmadı — Proje, haber taraması için halka açık SearXNG sunucularını kullanıyor; denediğim 15-20 kadar sunucunun neredeyse tamamı rate-limit veya bot koruması nedeniyle sonuç döndürmedi. Bu, raporun haber/duyarlılık kısmının kalitesini düşürüyor. Kesin bir çözümü yok; kendi SearXNG sunucunuzu kurmak veya bu özelliği görmezden gelmek gerekiyor.

Veri Kaynaklarının Güvenilirliği

ABD hisseleri (AAPL, NVDA, TSLA) için tek çalışan fiyat kaynağı YFinance oldu — diğer kaynaklar (efinance, akshare, pytdx, baostock) yalnızca Çin borsaları için çalıştığından ABD hisselerinde otomatik olarak atlanıyor. Testlerim boyunca YFinance'te herhangi bir rate-limit sorunu yaşamadım, üç hisse için de veri sorunsuz geldi.

Sınırlamalar

BIST (Borsa İstanbul) desteklenmiyor
Arayüz orijinalinde Çince/İngilizce (Türkçe için manuel çeviri gerekiyor)
Ücretsiz haber kaynağı güvenilir değil
Kurulum komut satırı bilgisi gerektiriyor, "tek tık" bir deneyim değil
Resmi rapor dili yalnızca Çince, İngilizce ve Korece olarak destekleniyor (Türkçe rapor üretimi yok, sadece arayüz metinleri çevrilebiliyor)

Sonuç

daily_stock_analysis, ücretsiz bir AI destekli hisse analiz aracı arayan ve biraz teknik kurulumdan çekinmeyen kullanıcılar için ilgi çekici bir proje. ABD hisseleri için veri kaynağı sorunsuz çalışıyor, AI modelinin ürettiği rapor detaylı ve anlaşılır. Ancak BIST desteğinin olmaması ve kurulumun teknik bilgi gerektirmesi, özellikle Türkiye'deki yatırımcılar için önemli bir sınırlama. Yine de eğitim ve deneme amaçlı, ABD piyasasına ilgi duyan biri için denemeye değer.

Not: Bu yazıda bahsedilen araç ve çıktıları yatırım tavsiyesi niteliği taşımaz, yalnızca bilgilendirme amaçlıdır.