Skip to content

SmartExpenseBot — Initial Public Release(v1.1.0)

Choose a tag to compare

@BotirBakhtiyarov BotirBakhtiyarov released this 17 Nov 19:22
· 6 commits to master since this release

🎉 SmartExpenseBot — Initial Public Release (v1.1.0)

We are excited to publish the first public release of SmartExpenseBot, an AI-powered personal finance assistant for Telegram.

This version includes complete expense tracking, voice transcription, scheduling, timezone detection, and multi-language support.


✨ What’s Included in This Release

💸 Expense Management

  • Add expenses using natural language

  • AI automatically extracts:

    • Amount
    • Currency
    • Category
    • Description
  • Multi-currency support (USD, EUR, CNY, RUB, UZS, and more)

  • Confirmation workflow for accuracy

  • Support for multiple expenses in a single message

  • Voice message support with Vosk STT models


📊 Reports & Insights

  • Ask natural language questions:

    • “Show my expenses this month”
    • “Food expenses last week”
    • “Total for December”
  • Category breakdown

  • Date range filtering

  • Spending summaries


⏰ Reminder System

  • AI-based natural language time parsing
  • Timezone-aware scheduling
  • “Remind me in 2 hours”
  • Warning notification + exact-time notification
  • Daily 20:00 expense reminders

🌍 Localization & Languages

  • Full support for:

    • English
    • Russian
    • Uzbek
  • Country → timezone detection

  • Location-based timezone setup


🎤 Voice Transcription

  • Uzbek / Russian / English
  • Automatic model loading
  • Efficient caching
  • FFmpeg-based audio conversion

🛠 Architecture & Tech Stack

  • Python 3.8+
  • pyTelegramBotAPI
  • SQLAlchemy (thread-safe)
  • APScheduler
  • DeepSeek AI
  • Vosk speech models

📦 Deployment Notes

  • Works with SQLite (development)
  • Works with PostgreSQL (production)
  • Safe to deploy on Railway / Render / VPS

🔒 Stability Notes

  • Automatic table creation (no manual migrations needed)
  • Existing data preserved
  • Thread-safe session handling

📣 Feedback

Found a bug? Have a feature request?
Open an issue on GitHub or message via Telegram Feedback in the bot.

New Contributors

Full Changelog: https://github.com/BotirBakhtiyarov/SmartExpenseBot/commits/1.1.0