A powerful Telegram bot designed to help Politecnico di Milano students find free classrooms for studying. Since the official PoliMi website no longer allows easy searching for free spaces, this bot fills the gap by scraping real-time data and filtering it based on your needs.
Ready to find a classroom? Start chatting with the bot now!
- Smart Search: Find free classrooms by Campus, Day, and Time slot.
- Power Plugs 🔌: Instantly see which classrooms have power outlets available.
- Customizable Interface: Toggle between Emoji Mode (compact) and Classic Text Mode via settings.
- High Performance: Implements Intelligent Caching (1 hour TTL) to ensure instant responses for repeated queries.
- Granular Opening Hours: Automatically respects specific building schedules
- Multi-language: Fully localized in Italian 🇮🇹 and English 🇬🇧.
- Docker Ready: Zero-config deployment with Docker and Docker Compose.
- User Friendly: Interactive keyboards and "Quick Search" (Now) button.
The easiest way to run the bot is using Docker. You don't need to install Python or dependencies manually.
docker run -d \
--name aulebot \
-e TOKEN="YOUR_TELEGRAM_BOT_TOKEN" \
--restart unless-stopped \
ghcr.io/gorlix/auleliberepolimi:latestThe repository already includes a docker-compose.yml file.
Simply edit docker-compose.yml to set your TOKEN (or use an .env file), and run:
docker-compose up -dIf you prefer running it directly on your machine:
-
Clone the repository:
git clone https://github.com/gorlix/AuleLiberePoliMi.git cd AuleLiberePoliMi -
Install Dependencies:
pip install -r requirements.txt
-
Configure Environment: Create a
.envfile in the root directory:TOKEN=your_telegram_bot_token
-
Run the Bot:
python3 bot.py
- Maintainer: Alessandro Gorla (Gorlix)
- Original Author: FeDann
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.