This project provides automated Telegram functionalities, including daily sign-ins, message monitoring, and auto-replies for personal chats, groups, and channels. It targets Telegram users seeking to automate routine interactions and manage group communications efficiently.

How It Works

The tool leverages the Telegram API to interact with user accounts, groups, and channels. For sign-ins, it supports timed or random-interval check-ins, can click predefined buttons on messages, and integrates with AI (OpenAI) for image recognition to select options. Message monitoring allows users to define matching rules (exact, contains, regex) for specific chats and users, with options for default replies or extracting replies via regex from messages.

Quick Start & Requirements

• Install: pip install -U tg-signer or pip install "tg-signer[speedup]" for performance.
• Prerequisites: Python 3.9+, OpenAI API key and optional base URL/model for AI features.
• Setup: Requires logging in via tg-signer login to obtain session data. Configuration is managed via CLI commands and stored in the .signer directory.
• Docs: README

Highlighted Details

• Supports AI-powered image recognition for clicking buttons.
• Advanced message monitoring with flexible matching rules and conditional replies.
• Can automate Telegram's built-in scheduled message feature.
• multi-run command allows simultaneous operation of multiple accounts with a single configuration.

Maintenance & Community

The project has seen regular updates, with recent versions adding support for DICE messages, fixing multi-account issues, and improving configuration. Community interaction channels are not explicitly mentioned in the README.

Licensing & Compatibility

The project is licensed under the GPL-3.0 License. This is a strong copyleft license, meaning derivative works must also be open-sourced under GPL-3.0.

Limitations & Caveats

The project does not provide a pre-built Docker image, requiring users to build it themselves. AI features require external API keys (OpenAI). Some advanced features like channel member listing require administrator privileges.