Skip to content

maax23/this_hafez_bot

 
 

Repository files navigation

📜 ربات تلگرام فال حافظ

ربات تلگرام فال حافظ، ابزاری برای دسترسی به دیوان حافظ با امکاناتی مانند گرفتن فال، دریافت غزل با شماره، تفسیر هوشمند، خوانش صوتی و تولید تصویر از غزل‌ها.


✨ امکانات

  • 🔮 گرفتن فال حافظ تصادفی
  • 📖 نمایش غزل بر اساس شماره (۱ تا ۴۹۵)
  • 🧠 تفسیر غزل (تولیدشده با هوش مصنوعی)
  • 🔊 خوانش صوتی غزل‌ها
  • 🖼️ تولید تصویر از غزل (با فونت فارسی)
  • 🎛️ دکمه‌های تعاملی تلگرام (Inline Keyboard)

🚀 نحوه استفاده در تلگرام

دستورات ربات

دستور توضیح
/start شروع کار و نمایش راهنما
/help راهنمای استفاده
/fall گرفتن فال حافظ

دریافت غزل با شماره

ارسال یک عدد بین ۱ تا ۴۹۵:

128

پس از آن می‌توانید:

  • تفسیر غزل را ببینید
  • خوانش صوتی را گوش دهید
  • تصویر غزل را دریافت کنید

🛠️ راه‌اندازی پروژه (برای توسعه‌دهندگان)

1️⃣ پیش‌نیازها

  • Python 3.10+
  • دسترسی به BotFather برای دریافت توکن
  • یک کانال تلگرام برای ذخیره فایل‌های صوتی (Storage)

2️⃣ نصب وابستگی‌ها

با pip

pip install -r requirements.txt

یا با uv (پیشنهادی)

uv sync

3️⃣ تنظیم متغیرهای محیطی

در ریشه پروژه فایل .env بسازید:

TOKEN=YOUR_TELEGRAM_BOT_TOKEN
STORAGE=@YOUR_STORAGE_CHANNEL

4️⃣ پایگاه داده

فایل پایگاه داده:

database.db

5️⃣ اجرای ربات

python main.py

🧰 تکنولوژی‌ها

  • Python
  • pyTelegramBotAPI
  • SQLite
  • Pillow (برای تولید تصویر)
  • python-decouple
  • uv (مدیریت وابستگی‌ها)

🔐 لاگ‌گیری

فعالیت‌ها و خطاها در فایل زیر ذخیره می‌شوند:

info.log

🧠 ایده‌های توسعه آینده

  • جستجوی غزل بر اساس متن یا بیت
  • انتخاب سبک تفسیر (عرفانی، عاشقانه، فلسفی)
  • ذخیره تاریخچه فال کاربران
  • نسخه وب یا API
  • چندزبانه‌سازی ربات

📣 لینک‌ها و پشتیبانی

  • 🤖 ربات: @this_hafez_bot

  • 📚 فیلولرن: https://PhiloLearn.t.me

  • 👤 پشتیبانی:

    • @Hr_ArshA
    • @max_23

📜 مجوز

این پروژه تحت مجوز موجود در فایل LICENSE منتشر شده است. استفاده، توسعه و بازنشر آن با حفظ حقوق مؤلف آزاد است 🌱

About

چیز خیلی جدی ای نیست، صرفا یه سرگرمی کوچیک برای خودم

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%