Not just a bot — a sysadmin assistant. A one-bot NOC panel for your VPS.
Speedo performs full diagnostics, plots performance trends, monitors health, and exports logs — all from Telegram.
Built on aiogram and optimized for deployment clarity, emoji-rich feedback, and admin-only control 👑🤩

• /start — Welcome message with usage tips (admin only)

• /speedtest — Full diagnostic:

  • Download / Upload / Ping
  • VPS uptime
  • Data sent / received
  • Server location + sponsor
  • Client location + ISP
  • Masked IP (randomized)
  • Thumbnail preview

• /trend — Speed graph using the last 30 tests

• /monthlytrend — Graph showing only results from the current month

• /lastspeed — Displays the latest speedtest snapshot in text format

• /healthscore — Emoji-based VPS performance rating (ping, bandwidth)

• /pwatch — Top 5 Resources-Heavy processes(with a refresh button 🔥

• /anomalywatch — 👻Auto watches your system with set threshold percentage & sends alerts ☄️

• anomalyreport — ☄️ Manually pull anomalyreport logs

• /anomalystatus — 👻 Anomalywatch status

• /resetanomaly — ☄️ Reset Anomaly

• /ping — ICMP ping test to 8.8.8.8, 1.1.1.1 ... if target address not specified (packet loss, latency stats)

• /exportlog — Sends the full speedlog.json file as a document

• /sysinfo — Current VPS system info:

  • 🧠 CPU model
  • ⏱️ Uptime
  • 💾 Disk usage
  • 📦 Memory usage
  • 📊 Load average

• /bootcheck — VPS boot time & uptime snapshot (admin only)

• /loadrings — VPS rings 💍

• /syschart — Graphical system telemetry panel:

  • RAM & Disk usage bars
  • CPU load + temperature
  • Load average trend
  • Network I/O stats
  • Last speedtest overlay
  • Random caption flair 🤩

• Auto Speedtest loop:

  • Runs silently every hour
  • Appends results to speedlog.json
  • Sends HTML summary to admin with timestamp & uptime

• 🖼️ Cleanly formatted results using HTML + emoji

• 🔒 Admin-only command access

• ⚙️ Built on Aiogram 3.7+

• There mayhap a 15sec cool down after deploy to enable auto monitor without error (bot will boot after 15sec)(maybe cos 🦔 is 👑)

git clone https://github.com/yuIlariy/speedo.git
cd speedo

sudo apt update

sudo apt install python3 python3-pip

python3 -m venv speedo
source speedo/bin/activate

pip3 install -r requirements.txt

Edit the config.py file:

TOKEN = "your_telegram_bot_token"
ADMIN_ID = 123456789       # Your Telegram numeric user ID
THUMBNAIL_URL = "https://telegra.ph/file/e292b12890b8b4b9dcbd1.jpg"

python3 bot.py

screen -S speedo

python3 bot.py

Detach: Ctrl + A, then Ctrl + D

Resume:

screen -r speedo

Stop: Ctrl + C, then

screen -S speedo -X quit

aiogram>=3.7.0
speedtest-cli
matplotlib
psutil

Original repo: yuIlariy/speedo
🍥 Telegram VPS bot extension by 🧠 Yuilariy x MS Copilot
🌍 Speedtest with style. Fork it. Use it. Credit it. Rule it 👑