README.md

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


<h1 align="center">BIST Predictor AI</h1>

<p align="center">
  <strong>Google TimesFM 2.5 Mimarisi ile Borsa ve Emtia Yön Tahmin Sistemi</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.11+-blue.svg" alt="Python Version">
  <img src="https://img.shields.io/badge/FastAPI-0.110.0-009688.svg" alt="FastAPI">
  <img src="https://img.shields.io/badge/PyTorch-2.0+-ee4c2c.svg" alt="PyTorch">
  <img src="https://img.shields.io/badge/TimesFM-2.5-ff6f00.svg" alt="TimesFM">
  <img src="https://img.shields.io/badge/CUDA-Supported-76b900.svg" alt="CUDA">
</p>

---

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.

```bash
# 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.

```bash
# 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.*