KouranBot

Telegram bot for power outage alerts in Mauritius. Subscribe to localities and get notified when outages are scheduled.

🤖 Try It Now

Open in Telegram →

or search for @Kouran_Bot in Telegram

Screenshots

Run Your Own Instance

If you want to host your own bot:

1. Get a bot token from @BotFather

2. Create .env file:

cp .env.example .env

3. Add your token to .env:

TELEGRAM_BOT_TOKEN=your_bot_token_here
POSTGRES_DB=kouranbot
POSTGRES_USER=kouranbot_user
POSTGRES_PASSWORD=your_secure_password

4. Start the bot:

docker-compose up -d

Commands

• /start - Welcome message
• /subscribe - Subscribe to localities
• /mysubscriptions - View subscriptions
• /unsubscribe - Remove all subscriptions
• /language - Switch between English/French
• /help - Help message

How It Works

1. Select a district
2. Choose localities within that district
3. Get notified when power outages are scheduled in your areas

The bot checks for new outages every 5 minutes.

Data Source

MrSunshyne/mauritius-dataset-electricity