Skip to content

Release 3.0.0 – AI Functionality

Choose a tag to compare

View all tags
@AlexTkDev AlexTkDev released this 13 Jul 12:49
· 68 commits to main since this release
3.0.0
0f954a7

🚀 Highlights

  • AI-powered Study Plan Generation
    The bot uses OpenAI and Groq LLMs to generate detailed, personalized study plans for any topic. If both APIs are unavailable, a local fallback generator is used.

  • Multilingual Support
    All bot messages, study plans, and reminders are automatically translated to the user's selected language (English, Russian, or Spanish) using LLMs (OpenAI or Groq fallback). If translation is not possible, the original English text is sent.

  • Robust Telegram UX
    All messages and buttons always contain non-empty text, eliminating Telegram errors.
    Keyboards (format selection, next actions) are always accompanied by a short message to ensure buttons are displayed reliably.

  • Language Selection Improvements
    Language selection buttons are not translated, ensuring the language filter works correctly and the user experience is seamless.

  • File Export
    Study plans can be exported to PDF or TXT files, with proper Unicode and font support.

  • Reminders
    The bot can schedule Telegram reminders for each step of your study plan.

  • Error Handling & Fallbacks
    If OpenAI is unavailable, the bot automatically falls back to Groq for both generation and translation. If both are unavailable, a local generator is used. All errors are logged and handled gracefully.

  • Full English Documentation & Comments
    All code comments, docstrings, and documentation are in English for international collaboration and clarity.

  • Simplified, Maintainable Codebase
    The logic is maximally simplified, with no unnecessary conditions; all stages work reliably and predictably.

  • TinyDB Storage
    All data is stored using TinyDB (no support for other databases).

🆕 How to Use

  1. /start – Greet the bot and select your language.
  2. /plan – Generate a new study plan for any topic.
  3. Choose file format – Save your plan as PDF or TXT.
  4. Set reminders – Schedule Telegram reminders for your study steps.
  5. /myplans – Retrieve your saved study plans.

🛠️ Technical Notes

  • Python 3.10+ and aiogram 3.x required.
  • All user-facing text is localized and translated in real time.
  • All environment variables are loaded from .env.
  • 100% test coverage for all core logic and handlers (pytest).
  • Project is ready for open source and further extension.
  • All code and comments must be in English.

📝 Upgrade Notes

  • No manual migration required.
  • If you use a previous version, simply update and follow the new English documentation.

Thank you for using EduPlannerBotAI! Contributions and feedback are welcome. )

Assets 2
Loading