Anonymous Telegram Chat Bot

An anonymous chat for Telegram.

Table of Contents

1. About The Project
2. Usage
3. Features

About The Project

This is a fun little Telegram bot that lets people chat anonymously. Messages are sent without showing who wrote them, so you can message freely without anyone knowing your identity. It’s just a simple project made for casual and open conversations—nothing too serious, just a way to chat without names attached!

Usage

To run the bot, start it using either Go or Docker.

---

Run using Docker Compose

1. Download the docker-compose.yaml file

   wget https://raw.githubusercontent.com/dafraer/anon-chat-tg-bot/refs/heads/main/docker-compose.yaml

2. Set architechture and environmental variables

   • Replace <your_telegram_bot_token> and <your_telegram_user_id> with actual values.
   • Set the image tag to 2.0-amd64 if you are running on x86_64

3. Run the command :

   sudo docker-compose up -d   

---

Run using Go

To run with Go you will need to set up PostgreSQL database yourself.

go run main.go $TOKEN $DB_URI $ADMIN_ID

Arguments / Environment Variables:

• TOKEN – Telegram Bot Token (Get it from @BotFather)
• DB_URI – PostgreSQL connection string
• ADMIN_ID – The bot admin’s Telegram ID (Find yours via @userinfobot)

---

Features

• Fully Anonymous Chat – Messages are copied and broadcasted to all users without revealing the sender’s identity.
• Root Users – Only root users can see the sender’s name (but not their username).
• Admin Control – The admin (set via CLI argument) can manage root users with:
  • /give_root [username] – Grants root access to a user.
  • /remove_root [username] – Revokes root access from a user.
• User Count Command – All users can check how many people are in the bot’s database with /count.