canokaue/telegram-anonymous-chat-bot

Anonymous ChatBot for communication with random interlocutors

🤖 Anonymous ChatBot in Telegram 📱

A ChatBot that allows users to exchange messages anonymously. The main idea is to allow people to communicate without having to reveal their identity. A bot was created for the demonstration @TokumeiChatto

System dependencies

• Python 3.11+
• Docker
• docker-compose
• make
• poetry

Deployment

1. Clone the repository:

   git clone https://github.com/Th3Kanashii/telegram-anonymous-chat-bot.git

2. Rename .env.dist to .env and configure it:

   Rename the .env.dist file to .env and specify the necessary parameters for the bot to work.

3. Build the application and run the bot:

   Execute the following commands:

   make app-build
   make app-run

Development

Setup environment

poetry install

Update database tables structure

Make migration script:

make migration message=MESSAGE_WHAT_THE_MIGRATION_DOES rev_id=ID_MIGRATION

Run migrations:

make migrate

Update locales

1. Parse new used localization keys to update locales files (make i18n locale=TRANSLATION_LOCALE)
2. Write new locales in .ftl files by translations/TRANSLATION_LOCALE
3. Restart the bot

Used technologies

• Aiogram 3.x (Telegram bot framework)
• PostgreSQL (database)
• SQLAlchemy (working with database from Python)
• Alembic (lightweight database migration tool)
• Project Fluent (modern localization system)