NSTU Helper Telegram Bot

Telegram bot for NSTU freshmen. The bot provides quick navigation through useful information, campus events, popular places, and simple surveys in Russian and English.

Features

• RU/EN language switch
• Inline menu navigation
• Useful freshman information
• Campus event reminders
• Food and leisure survey
• Popular places based on survey answers
• Simple modular structure based on aiogram 3

Project structure

app/
  handlers/       # Telegram message and callback handlers
  services/       # Data/services layer
  states/         # FSM states
  utils/          # Keyboards and localization helpers
  config.py       # Environment configuration
  main.py         # Bot entry point
public/           # README images
.env.example      # Example environment variables
requirements.txt  # Python dependencies

Installation

Requires Python 3.10+.

git clone https://github.com/HontoUKI/Telegram_Bot.git
cd Telegram_Bot

python -m venv .venv

Windows PowerShell

.venv\Scripts\Activate.ps1
pip install -r requirements.txt
copy .env.example .env

Linux / macOS

source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Then open .env and set your Telegram bot token:

BOT_TOKEN=your_real_token_here

Run

python -m app.main

Screenshots

Notes

The current survey storage in app/services/db.py is an in-memory fallback for local testing. Survey answers are lost after restart. For production usage, replace it with SQLite/PostgreSQL or another persistent storage.

Security

Never commit .env or real bot tokens. Use .env.example only as a template.