README.md

metadata

title: BIST Predictor
emoji: 📈
colorFrom: green
colorTo: blue
sdk: docker
pinned: false

BIST Predictor AI

Google TimesFM 2.5 Mimarisi ile Borsa ve Emtia Yön Tahmin Sistemi

---

BIST Predictor, Borsa İstanbul (BIST-100) hisseleri ve majör global emtiaların (Altın, Gümüş, Petrol vb.) gelecekteki fiyat rotalarını tamamen yapay zeka ile otonom olarak öngören bir finansal analiz sistemidir. Duygulardan ve klasik indikatör yanılgılarından arındırılmış bu platform, piyasanın hareketlerini 10, 30 ve 90 günlük horizonlarda "nokta atışı" analiz eder.

✨ Temel Özellikler

• 🧠 Google TimesFM 2.5: Zaman serisi analizinde gelmiÅŸ geçmiÅŸ en güçlü foundation modellerinden olan 200 Milyon parametreli TimesFM entegrasyonu.
• 🕒 Çoklu Ufuk (Horizon) Analizi: Sadece yarına deÄŸil; 10, 30 ve 90 iÅŸ günü sonrasına projeksiyonlar.
• 🎯 Dinamik Puanlama Sistemi (Güven Puanı): Model her sabah kendi dünkü tahminini bugünün gerçek fiyatıyla yüzleÅŸtirir. Yön DoÄŸruluÄŸu, MAPE (Hata Oranı) ve Volatilite istikrarına göre hisselere "Güven Puanı" atar.
• 📈 P10-P90 Risk Bantları (Quantile): Fiyatın sadece nereye gideceÄŸini deÄŸil, hangi fiyat bandı içine oturacağını (Quantile) belirler.
• 🏎️ GPU Hızlandırma & CUDA: PyTorch aracılığıyla NVIDIA GPU'lar üzerinde asenkron (batch) iÅŸlem yeteneÄŸi.
• 💎 Premium Dashboard: Cam efekti (glassmorphism), gerçek zamanlı bildirimler, Chart.js grafik entegrasyonu ile ultra modern ve karanlık mod odaklı arayüz.

🛠️ Teknoloji Yığını

• Backend: Python, FastAPI, SQLite (Hafif ve hızlı), APScheduler
• AI/ML: PyTorch, Google TimesFM
• Veri SaÄŸlayıcı: yfinance (Yahoo Finance)
• Frontend: HTML5, CSS3 (Vanilla + CSS Variables), Vanilla JavaScript, Chart.js, Server-Sent Events (SSE)

🚀 Hızlı Kurulum (Local GPU / CPU)

Sistemin kurulumu için Python 3.11+ yüklü olmalıdır. GPU kullanımı için NVIDIA sürücülerinin ve CUDA (PyTorch için) kurulu olması zorunludur.

# 1. Repoyu Klonlayın
git clone https://github.com/alperenucan/BistPredictor.git
cd BistPredictor

# 2. Sanal Ortam Oluşturup Bağımlılıkları Yükleyin
python -m venv venv
venv\Scripts\activate  # Windows İçin
# source venv/bin/activate # Linux/Mac İçin
pip install -r backend/requirements.txt

# 3. TimesFM Kitaplığını Yükleyin
pip install tsagentkit-timesfm[torch]

# 4. Sistemi Çalıştırın
python backend/main.py

Sistem ayaÄŸa kalktığında http://localhost:8000 adresinden anında kullanmaya baÅŸlayabilirsiniz!

🐋 Docker ile Deploy (Bulut Ortamları)

Projeyi başka bir sunucuya (RunPod, AWS, VDS vb.) kolayca deploy edebilmeniz için Docker desteklenmektedir.

# Docker imajı build et
docker build -t bistpredictor .

# Sistemi GPU yetkileriyle ayağa kaldır
docker run -d -p 8000:8000 --gpus all \
  -v ./backend/data:/app/backend/data \
  bistpredictor:latest

⏱️ Otonom Görev Zamanlayıcı (APScheduler)

Sistemi kapatmadığınız sürece arka planda kendiliğinden veri madenciliği yapar:

• Hafta İçi Her AkÅŸam (18:30): Borsa kapandıktan sonra tüm hisselerin güncel verisi çekilir ve gelecekteki 10-30-90 rotası hesaplanıp kaydedilir.
• Hafta İçi Her Sabah (10:00): Piyasalar açılırken dünkü hedefler bugünün piyasa gerçekleriyle test edilir ve model her hisse için kendini "Puanlar".

📜 Lisans

MIT. Her yoruma ve katkıya açıktır.

---

Disclaimer: Bu araç tamamen yapay zeka modellemesine dayanmaktadır ve finansal piyasalardaki riskleri sıfırlamaz. Sistem tarafından üretilen tahminler, kesinlikle yatırım tavsiyesi (YTD) değildir.