🔮 Fortune Teller Bot

Fortune Teller Bot, kullanıcılara Telegram üzerinden astroloji, kahve falı ve tarot tadında kişiselleştirilmiş mistik yorumlar yapan yapay zeka destekli bir sohbet botudur.

Standart kalıp cümlelerin aksine, bu bot Google Gemini 3 Flash modelinin hızını ve zekasını kullanarak, kullanıcının sorduğu sorulara anında, akıcı ve tamamen bağlama uygun "falcı" personasıyla yanıtlar üretir.

🚀 Özellikler

• 🎭 Gerçekçi Falcı Personası: Sadece burç yorumu yapmaz; aklınızdaki bir soruya, bir isme veya dertleşmek istediğiniz bir konuya mistik bir üslupla yaklaşır.
• ⚡ Yüksek Hız & Düşük Gecikme: Google'ın low-latency odaklı Gemini 3 Flash modeli ve asenkron (async) Telegram altyapısı sayesinde mesajlara saniyeler içinde dönüş yapar.
• ☁️ 7/24 Kesintisiz Hizmet: Render bulut sunucusu üzerinde barındırıldığı için yerel bilgisayarınız kapalı olsa bile sürekli çevrimiçidir.

---

⚙️ Nasıl Çalışır?

1. Etkileşim: Kullanıcı Telegram üzerinden bota direkt bir soru yazarak ulaşır.
2. Prompt Mühendisliği: Kullanıcının mesajı, arka planda bota "gizemi, samimiyeti ve astrolojik öngörüleri harmanlayan bir bilge" kimliği yükleyen özel bir sistem komutuyla birleştirilir.
3. Yapay Zeka Üretimi: Gemini 3 Flash API, bu verileri işleyerek sanki bir fincan kahveye veya tarot kartlarına bakıyormuşçasına etkileyici bir metin oluşturur.
4. Hızlı Teslimat: Üretilen yanıt anında kullanıcının Telegram sohbetine düşer.

---

🛠️ Kurulum

Bu proje, Render.com gibi bulut platformlarında 7/24 çalışacak şekilde optimize edilmiştir. Kendi botunuzu kurmak için aşağıdaki adımları izleyebilirsiniz:

1. Projeyi Forklayın 🍴

Sayfanın sağ üst köşesindeki Fork butonuna tıklayarak bu projeyi kendi GitHub hesabınıza ekleyiniz.

2. Gerekli Anahtarları Edinin 🔑

• Google Gemini API Key: Google AI Studio adresinden ücretsiz anahtarınızı alınız.
• Telegram Bot Token: Telegram'da @BotFather ile sohbet başlatıp /newbot komutuyla kendi botunuzu oluşturun ve size verilen HTTP API Token'ı kopyalayınız.

3. Render Üzerinde Canlıya Alın ☁️

1. Render.com adresine GitHub hesabınızla giriş yapın.
2. New > Web Service adımlarını izleyerek forklayıp oluşturduğunuz deponuzu seçin.
3. Ayarları şu şekilde doldurun:
   • Runtime: Python 3
   • Build Command: pip install -r requirements.txt
   • Start Command: python main.py
4. Sayfanın altındaki Environment Variables bölümüne giderek gizli anahtarlarınızı ekleyin:
   • TELEGRAM_TOKEN = (BotFather'dan aldığınız token)
   • GEMINI_API_KEY = (Google AI Studio'dan aldığınız anahtar)
5. Create Web Service butonuna basarak botunuzu başlatın!

💻 Yerel (Local) Kurulum: Botu kendi bilgisayarınızda denemek isterseniz; repoyu klonlayıp pip install -r requirements.txt komutuyla kütüphaneleri kurabilir, ana dizinde .env dosyası oluşturarak aldığınız tokenleri/anahtarları içine yazdıktan sonra python main.py komutuyla çalıştırabilirsiniz.

---

📞 İletişim & Destek

Proje ile ilgili bir hata fark ederseniz veya özellik isteğiniz varsa lütfen GitHub üzerinden bir Issue açmaktan çekinmeyin.

---

⚠️ Yasal Uyarı

Bu bot, tamamen eğlence ve motivasyon sağlamak amacıyla yapay zeka dil modelleri kullanılarak tasarlanmıştır.

• Kesinlik: Üretilen içerikler rastgele yapay zeka algoritmalarına dayanır ve geleceği okuma, tahmin etme gibi bir işlevi/kesinliği yoktur.
• Tavsiye Niteliği Taşımaz: Bot tarafından verilen cevaplar; psikolojik, finansal, medikal veya hukuki bir tavsiye yerine geçmez. Ciddi kararlarınızda lütfen uzmanlara danışınız.

---

Made with ❤️ by Yusuf Sami Turan