mathigatti/telegram-ai-secretary

Telegram AI Secretary is a self hosted tool that lets you keep Telegram muted without missing messages that actually matter. It watches your Telegram account, decides which incoming messages deserve your attention, and only pushes the important ones to your phone as a notification through a service called ntfy. The idea behind it is that phones have become so noisy that many people turn notifications off entirely, but then end up checking the app constantly just in case something urgent came in. This project tries to solve both problems at once by acting like a personal secretary: quiet by default, but able to let real interruptions through, such as an incoming call, someone asking to meet the same day, or a message saying someone is waiting at the door. Under the hood, the tool listens to Telegram events using a library called Telethon. Simple, obvious cases are handled by fast rules you define yourself, so the tool does not need to think twice about routine situations like ignoring group chats you are not mentioned in, or always notifying you about phone calls. When a private message does not match one of those fast rules, the tool sends it, along with recent conversation history, to Claude, which decides whether the message is worth a notification and how urgent it is. You can manage do not disturb periods, add or remove fast rules, and inspect past decisions from the command line. The app keeps its own local files for rules, preferences, conversation history, and decision logs, and these are excluded from version control since they can contain private message content, names, and Telegram account details. Setting it up requires Python 3.10 or newer, a Telegram API key from Telegram's developer site, an ntfy topic to receive alerts, and the Claude command line tool installed and logged in. The README also includes a systemd service template for running it continuously on a Linux server. The author is explicit that this is not a message forwarding tool: it does not copy your messages elsewhere, it only decides whether a given message should interrupt you, which makes it closer to a personal attention filter than a chat bridge.