Skip to content
Back to projects

Smoke Alarm Telegram Bot

A Telegram bot for coordinating group smoke breaks.

Year
2025–2026
Role
Concept, bot development, and deployment
Smoke Alarm bot call with participants, weather, and join button

Overview

A group bot made for fun and then expanded into a surprisingly complete little social tool. A smoke call mentions the squad with a randomized message, adds the caller automatically, lets others join or change their mind with an inline button, and includes current Almaty weather. It also keeps history, leaderboards, opt-in state, and workday weather subscriptions.

Technology

  • Python
  • Telegram Bot API
  • SQLite
  • Open-Meteo API
  • Docker
  • Docker Compose
  • uv

Built around

  1. Inline participation updates the original message, so the group can see who is going without a thread of replies.
  2. SQLite persists users, opt-in state, calls, participation, and statistics across restarts.
  3. Randomized Russian copy and real weather make a repetitive utility feel specific to the group using it.

If I kept going

  1. Add stronger concurrency handling when several smoke calls or button presses happen together.
  2. Cover command, callback, migration, and scheduled-notification flows with automated tests.
Next projectFalco