Sarkooft is an intelligent, witty Habit Tracker for Telegram. This bot doesn't just track your daily activities; it analyzes your productivity and serves you a fresh, biting "Sarkooft" (a sarcastic roast) based on your performance.
Our philosophy is simple: The more productive you are, the less you get roasted—but even at your best, you’re not entirely safe from our sarcasm.
- Intelligent Tracking: Precise logging for Study, Work, Exercise, Reading, Learning, and Personal Projects.
- Performance Analytics: Automated daily score calculations with tiered performance feedback (Low, Medium, High).
- Dynamic Roast Engine: A sophisticated, non-repetitive system that serves sarcastic comments tailored to your output.
- Anti-Cheat System: Robust input validation to prevent unrealistic or "space-time" entries.
- Admin Dashboard: A private, secure interface for admins to monitor bot growth and manage global broadcasts.
We use a weighted system to balance physical effort against intellectual output:
| Activity | Points per Unit | Daily Cap |
|---|---|---|
| Work | 10.0 | 14 Hours |
| Study | 10.0 | 10 Hours |
| Personal Project | 12.0 | 12 Hours |
| Exercise | 0.4 | 120 Minutes |
| Learning | 8.0 | 10 Hours |
| Reading | 0.5 | 150 Pages |
- Language: Python 3.x
- Library:
pyTelegramBotAPI(telebot) - Database: PostgreSQL (via Supabase)
- Connectivity:
psycopg2for high-performance DB interaction
- Clone the repository:
git clone https://github.com/yourusername/sarkooft-bot.git
cd sarkooft-bot
- Configure Environment:
Create a .env file in the root directory:
BOT_TOKEN=your_telegram_bot_token
DATABASE_URL=your_postgres_connection_string
ADMIN_IDS=your_telegram_id
- Install Dependencies:
pip install -r requirements.txt
- Run the bot:
python bot.py
We love community contributions! If you want to make the bot even more "toxic" (or useful), here’s how:
- Fork the Repo: Click the Fork button at the top right.
- Create a Branch:
git checkout -b feature/amazing-new-roast - Commit Your Changes:
git commit -m 'Add a devastating new roast' - Push to Branch:
git push origin feature/amazing-new-roast - Open a Pull Request: Explain your changes and wait for a review!
Note: Please ensure all code follows the existing style, and don't forget to update the roasts.json file if you're adding new content!
This project blends Productivity with Satire. We believe that tracking habits shouldn't be a boring, soul-crushing chore—it should be an experience that pushes you to do better, if only to stop the bot from making fun of you.
If you like this project, please give it a Star! ⭐