Repository navigation
SmartExpenseBot — Initial Public Release(v1.1.0)
🎉 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
- @dependabot[bot] made their first contribution in #1
Full Changelog: https://github.com/BotirBakhtiyarov/SmartExpenseBot/commits/1.1.0