AI Habit Tracker Telegram Bot
The free, open-source AI Habit Tracker and life log that lives directly inside Telegram. Track study hours with live stopwatch timers, count daily habits, log sleep, write AI reflections, and audit wasted time with Google Gemini AI.
💧 Drink Water: 3,500 / 5,000 ml (70%)
😴 Sleep: 7 hours 15 min
⏱️ Physics Study: 2 hours 45 min
🕳️ Wasted: 4 hours 18 min of 14 hours elapsed
Complete Capabilities
What the AI Habit Tracker Bot Does
Engineered for real life. It handles midnight roll-overs, pauses, phone-screen distractions, and mathematical accountability.
Live Stopwatch Timer
Start study or work sessions in Telegram with real-time elapsed seconds. Pause when stepping away, resume when back. Paused time is strictly excluded from final logs.
Dedicated Sleep System Timer
Undeletable system timer. Tap Start at bedtime and Stop on waking. Sessions split automatically at midnight (e.g. 11 PM to 12 AM on Day 1, 12 AM to 7 AM on Day 2).
Habit Counters & Daily Ticks
Log water intake (ml), workout reps, or book pages with quick +1, +5, +10 buttons or typed values. Daily yes/no routines (vitamins, morning walk) are ticked in 1 tap.
Deterministic Wasted Time Audit
Every minute of the day is accounted for. Unaccounted time = elapsed day minutes − all tracked timers (study + sleep). Zero guessing, zero wishful thinking.
AI Diary & Reflection (/log)
Type how your day went. Google Gemini AI reads your reflection and automatically extracts summary, mood, people mentioned, project tags, and key decisions.
Deterministic Ask AI (/ask)
Ask in natural language: "How much did I study this month?" or "How much time did I waste yesterday?". Gemini selects tools; all arithmetic is executed by TypeScript.
Focus Tagging & Session Notes
When you stop a work timer, rate your session: Focused, Casual, or Distracted. Add a quick 1-sentence note of what you accomplished.
Doubts & Questions Organizer
Send /doubt to log questions while studying. Gemini automatically suggests or merges into existing topics. Browse doubts with 5-per-page pagination and mark resolved.
To-Dos & Timely Reminders
Schedule one-off tasks with /todo specifying date and time. The bot notifies you right when it's due, with an inline button to mark completed.
Cheat Sheet
AI Habit Tracker Telegram Commands
Everything you need is accessible via simple Telegram slash commands or quick-tap buttons.
| Command | Action | What it does |
|---|---|---|
| /start | Main Menu | Displays today at a glance, quick habit buttons, and active timer controls. |
| /today | Full Scorecard | Habits, routines, diary summary, and unaccounted wasted time. |
| /tasks | View & Log | Start timers, increment counters, or check daily routines. |
| /addtask | Create Task | Guided wizard to create a timer, counter, or daily tick with reminders. |
| /edit | Edit / Archive | Modify reminder time, target goals, schedule, or soft-delete habits. |
| /todo | Scheduled Reminders | One-time to-dos with exact calendar date and clock time reminders. |
| /doubt | Academic Doubts | Record doubts, auto-clustered by AI topic, with pagination & toggle. |
| /log | AI Diary | Reflect on your day. Gemini extracts mood, summary, and links task notes. |
| /ask <query> | AI Data Analysis | Ask anything about your logs, study habits, or wasted hours. Zero hallucinations. |
| /status | Stopwatch Status | Brings running timer controls back to the newest Telegram message. |
5-Minute Setup Walkthrough
How to Deploy Your AI Habit Tracker Bot
You need three 100% free accounts: Telegram, Supabase, and Google AI Studio. Follow these 5 steps to launch your private bot.
Get the Source Code
Download the production-ready code zip directly from this page, or clone the repository to your machine:
git clone https://github.com/metamotion7/telegram-life-log.gitGet Your Free API Keys
- •Telegram Bot Token: Open Telegram, message @BotFather, send
/newbot, follow the prompts, and copy the HTTP API Token. - •Supabase Database: Go to supabase.com (free tier), create a new project, and go to Project Settings → API to copy your Project URL and
service_rolesecret key. - •Google Gemini API Key: Visit aistudio.google.com, click Create API Key. It provides free generous quotas.
- •Your Telegram ID: Message @userinfobot to get your numeric ID. This locks the bot exclusively to you.
Run the Database SQL Schema
Open your Supabase Dashboard → SQL Editor. Copy and paste the contents of supabase/schema.sql (from the downloaded zip or repo), and click Run.
tasks, logs, active_timers, todos, doubts, and starter habits.Deploy to Vercel & Set Environment Variables
Import your repository into vercel.com (Next.js preset) and add these environment variables in project settings:
Activate Webhook & Minute Cron
Point Telegram to your live Vercel URL by running this one command in your browser or terminal:
To keep timers ticking and reminders triggering every minute:
Create a free 1-minute cron job on cron-job.org pointing to: https://<YOUR_APP>.vercel.app/api/tick?key=<CRON_SECRET>
npm run poll on your Mac or PC! It automatically clears any webhooks, long-polls Telegram directly, refreshes timers every 5 seconds, and delivers reminders locally.Common Questions
AI Habit Tracker FAQ
Everything you need to know about using this free AI Habit Tracker Telegram Bot.
What is an AI Habit Tracker Telegram Bot?＋
An AI Habit Tracker Telegram Bot is a free, personal productivity assistant that lives directly inside Telegram. It tracks daily habits, study stopwatch sessions, sleep hours, and calculates wasted time — powered by Google Gemini AI — with no subscription fees.
Is this AI Habit Tracker free and open-source?＋
Yes — 100% free and open-source under the MIT license. It deploys on the free tiers of Vercel, Supabase, and Google AI Studio, so you pay nothing ongoing. Download the source code directly from this page.
How does the AI analyse my habits and study time?＋
When you send /ask, Google Gemini AI converts your natural-language question into an exact SQL query executed against your private Supabase database. All arithmetic is done deterministically in TypeScript — zero hallucinated numbers.
Does the AI Habit Tracker work without a premium Telegram subscription?＋
Yes. It works with any free Telegram account. You self-host the bot on Vercel's free hobby plan; there are no Telegram Premium requirements.
How is this different from other AI habit tracker apps?＋
Unlike app-based trackers, this AI Habit Tracker lives inside Telegram — no extra app installs. It's single-user and privacy-first: your data stays in your own Supabase database. It also computes wasted time deterministically rather than estimating it.
Can I track study time with this AI Habit Tracker?＋
Yes. The live stopwatch lets you start a named study session (e.g., Physics Study), pause and resume it, and the bot nudges you every 5 minutes while running. Sessions automatically split at midnight for accurate daily logs.