No description
Find a file
un-oeil fce314e1e0 Initial barberousse bot: Telegram commands, Pterodactyl deploy notes
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 14:12:13 +02:00
.env.example Initial barberousse bot: Telegram commands, Pterodactyl deploy notes 2026-10-13 14:12:13 +02:00
.gitignore Initial barberousse bot: Telegram commands, Pterodactyl deploy notes 2026-10-13 14:12:13 +02:00
app.py Initial barberousse bot: Telegram commands, Pterodactyl deploy notes 2026-10-13 14:12:13 +02:00
kuma.py Initial barberousse bot: Telegram commands, Pterodactyl deploy notes 2026-10-13 14:12:13 +02:00
README.md Initial barberousse bot: Telegram commands, Pterodactyl deploy notes 2026-10-13 14:12:13 +02:00
requirements.txt Initial barberousse bot: Telegram commands, Pterodactyl deploy notes 2026-10-13 14:12:13 +02:00

barberousse

Telegram bot that answers questions about the homelab's Uptime Kuma. Kuma itself still sends the alerts (same bot token); this bot only adds commands.

Command Reply
/status Every status-page group at a glance (✅ or what's down)
/down Only what is down or pending, since when, last error
/monitor <name> One monitor: state, response time, 24 h uptime, last 10 checks
/uptime 24 h uptime, worst first

Optional: a daily digest (DIGEST_TIME) and a heartbeat to a Kuma Push monitor (KUMA_PUSH_URL).

It reads Kuma's public status page API (/api/status-page/<slug> and /api/status-page/heartbeat/<slug>): read-only, no Kuma login. It only answers the chat IDs in ALLOWED_CHAT_IDS.

Run locally

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
cp .env.example .env   # fill in the token
.venv/bin/python app.py

Deploy on Pterodactyl (python generic egg)

Server barberousse on node wings.

Variable Value
GIT_ADDRESS https://forgejo.un-oeil.fr/un-oeil/barberousse.git
USERNAME / ACCESS_TOKEN Forgejo user + token with read:repository only
AUTO_UPDATE 1 (git pull on every restart)
PY_FILE app.py
REQUIREMENTS_FILE requirements.txt
  1. Set the variables, then Reinstall (the install clones the repo into an empty folder).
  2. Files → create .env from .env.example. It is git-ignored, so git pull never touches it.
  3. Start. The console shows Barberousse starting (...).

To update: push to Forgejo, then Restart the server.