🤫 Whisper Telegram Bot

A privacy-focused Telegram bot for sending "whisper" messages in groups.

Features • Installation • Configuration • Tech Stack • Contributing

Whisper Bot allows users to send hidden messages ("whispers") in public Telegram groups. The content of the message is hidden behind a button and can only be viewed by the sender and the specified recipient.

It works primarily via Inline Mode, meaning you can use it in any chat without adding the bot as a member.

• Inline Whispers: Type @{bot_username} message @username in any chat.
• Privacy First: Only the sender and the target recipient can see the message text.
• Smart Suggestions: The bot remembers your frequent contacts for quick access.
• User-Friendly Interface:
  • Manual username/ID entry.
  • Select user from contacts via private chat.
• Internationalization (i18n):
  • English
  • Russian
• Robust Backend: Built with asynchronous Python and PostgreSQL.

The easiest way to run the bot is using Docker Compose.

• Docker & Docker Compose installed.
• A Telegram Bot Token obtained from @BotFather.

1. Clone the repository:

   git clone https://github.com/bchudo/whisper-telegram
   cd whisper-telegram

2. Configure environment variables: Rename .env.example to .env and populate it with your data.

   mv .env.example .env
   nano .env  # or use any text editor

3. Run with Docker:

   docker-compose up -d --build

4. Bot settings: Make sure to enable Inline Mode for your bot in @BotFather (/mybots -> Select Bot -> Bot Settings -> Inline Mode -> Turn on). And enable Inline Feedback for your bot on 100%

• Language: Python 3.11
• Framework: aiogram 3.x (Asynchronous Telegram Bot API framework)
• Database: PostgreSQL
• Driver: asyncpg (High-performance async PostgreSQL driver)
• I18n: fluent & aiogram-i18n
• Infrastructure: Docker & Docker Compose

If you want to run the bot locally without Docker:

1. Create a virtual environment:

   python -m venv venv
   source venv/bin/activate  # on Windows: venv\Scripts\activate

2. Install dependencies:

   pip install -r requirements.txt

3. Ensure you have a PostgreSQL database running and configure .env to point to localhost.
4. Run the bot:

   python -m whisper

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

Distributed under the MIT License. See LICENSE for more information.