What is telegram-invite-automation?

This repository describes a Python tool for automatically adding Telegram users to a group or channel, despite framing itself with softer language like "introductions" and "digital ambassador" rather than calling it a member adding bot. Stripped of that framing, the README describes a script that logs into a Telegram account through the MTProto API, finds users in other groups that match a target profile, and adds them to the owner's own group or channel automatically. According to the README, the tool includes rate limiting features meant to imitate human browsing patterns and avoid Telegram's spam detection, such as randomized delays between actions, daily interaction caps, and account health monitoring that adjusts pacing based on how the account is being treated by Telegram. It documents a YAML configuration format for setting daily limits, active hours, and target group filters like member count and language, plus proxy rotation support and a Docker deployment option with a web dashboard for tracking results. The README also describes optional OpenAI and Claude API integration for generating personalized introduction messages based on a target group's recent conversation history and tone, with configuration snippets showing where an API key would go. It lists support across Windows, macOS, Linux, Raspberry Pi, and a beta mode on Android through Termux, along with a partially completed set of language translations for the interface. Mass adding users to a Telegram group without their direct action is against Telegram's terms of service and is commonly treated as spam behavior by the platform, regardless of how gently a tool describes what it does. Automation designed specifically to evade a platform's spam detection carries a real risk of account bans, and depending on how it is used, may also raise privacy and consent concerns for the people being added.