Fortune Teller Bot is an AI-powered chatbot that provides users with personalized mystical readings via Telegram, combining the flavors of astrology, coffee cup reading, and tarot.
Unlike standard template sentences, this bot uses the speed and intelligence of the Google Gemini 3 Flash model to generate instant, fluent, and highly contextual responses to user questions in a "fortune teller" persona.
- 🎭 Realistic Fortune Teller Persona: It doesn't just give horoscope readings; it approaches your questions, a specific name, or a topic you want to vent about with a mystical tone.
- ⚡ High Speed & Low Latency: Thanks to Google's low-latency focused Gemini 3 Flash model and asynchronous (async) Telegram infrastructure, it replies to messages within seconds.
- ☁️ 24/7 Uninterrupted Service: Since it is hosted on the Render cloud server, it remains continuously online even if your local computer is turned off.
- Interaction: The user contacts the bot by writing a direct question via Telegram.
- Prompt Engineering: The user's message is combined with a special system command in the background that assigns the bot the identity of a "wise figure who blends mystery, sincerity, and astrological foresight."
- AI Generation: The Gemini 3 Flash API processes this data and creates an impressive text as if looking into a coffee cup or reading tarot cards.
- Fast Delivery: The generated response instantly drops into the user's Telegram chat.
This project is optimized to run 24/7 on cloud platforms like Render.com. You can follow the steps below to set up your own bot:
Add this project to your own GitHub account by clicking the Fork button in the top right corner of the page.
- Google Gemini API Key: Get your free key from Google AI Studio.
- Telegram Bot Token: Start a chat with @BotFather on Telegram, create your own bot using the
/newbotcommand, and copy the provided HTTP API Token.
- Log in to Render.com with your GitHub account.
- Follow New > Web Service and select your forked repository.
- Fill in the settings as follows:
- Runtime:
Python 3 - Build Command:
pip install -r requirements.txt - Start Command:
python main.py
- Runtime:
- Go to the Environment Variables section at the bottom of the page and add your secret keys:
TELEGRAM_TOKEN= (The token you got from BotFather)GEMINI_API_KEY= (The key you got from Google AI Studio)
- Start your bot by clicking the Create Web Service button!
💻 Local Installation: If you want to test the bot on your own computer; you can clone the repo and install the libraries with the
pip install -r requirements.txtcommand, create a.envfile in the root directory, paste your tokens/keys inside, and run it with thepython main.pycommand.
If you notice a bug or have a feature request regarding the project, please don't hesitate to open an Issue on GitHub.
This bot is designed entirely for entertainment and motivation purposes using artificial intelligence language models.
- Accuracy: The generated content relies on random AI algorithms and has no function/certainty of reading or predicting the future.
- Not Advisory: The answers provided by the bot do not substitute for psychological, financial, medical, or legal advice. Please consult experts for your serious decisions.
Made with ❤️ by Yusuf Sami Turan
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.
- 🎭 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.
- Etkileşim: Kullanıcı Telegram üzerinden bota direkt bir soru yazarak ulaşır.
- 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.
- 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.
- Hızlı Teslimat: Üretilen yanıt anında kullanıcının Telegram sohbetine düşer.
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:
Sayfanın sağ üst köşesindeki Fork butonuna tıklayarak bu projeyi kendi GitHub hesabınıza ekleyiniz.
- 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
/newbotkomutuyla kendi botunuzu oluşturun ve size verilen HTTP API Token'ı kopyalayınız.
- Render.com adresine GitHub hesabınızla giriş yapın.
- New > Web Service adımlarını izleyerek forklayıp oluşturduğunuz deponuzu seçin.
- Ayarları şu şekilde doldurun:
- Runtime:
Python 3 - Build Command:
pip install -r requirements.txt - Start Command:
python main.py
- Runtime:
- 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)
- 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.txtkomutuyla kütüphaneleri kurabilir, ana dizinde.envdosyası oluşturarak aldığınız tokenleri/anahtarları içine yazdıktan sonrapython main.pykomutuyla çalıştırabilirsiniz.
Proje ile ilgili bir hata fark ederseniz veya özellik isteğiniz varsa lütfen GitHub üzerinden bir Issue açmaktan çekinmeyin.
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