# netmon

> Self-hosted network monitor running hourly speed tests, LAN ARP scans, and delivering sarcastic AI 24-hour reports with graphs to Telegram or Discord.

- **Category:** Network Monitoring
- **Licence:** MIT
- **Latest version:** 0.1.0
- **Open source:** oss
- **Languages:** Python
- **Platforms:** pip
- **Tags:** SQLite, Discord, Speedtest, Network Monitoring, AI, Python, Telegram bot, Nmap, Self Hosted, Discord Bot, Bandwidth monitoring, Discord webhook, Telegrambot, Uv, LAN Scanning

## Description

netmon is a Python-based network monitoring bot you run on your own macOS or Linux machine. It executes a single-threaded speed test every half hour using speedtest-cli and counts active LAN devices via nmap ARP scans. Results are kept in a local SQLite file. Every four hours the tool renders a matplotlib chart of the last 24 hours and ships a report with sarcastic AI commentary to Telegram or a Discord webhook. The LLM client works with any OpenAI-compatible endpoint, so you can point it at a local Ollama or LM Studio server. Setup relies on uv for Python and dependency management, plus system-installed nmap and speedtest-cli with passwordless sudo for nmap. The code is MIT-licensed.

## Links

- [Homepage](https://github.com/role1776/netmon)
- [GitHub Repository](https://github.com/Role1776/netmon)

---
Source: https://selfhost.directory/project/netmon