Open source · MIT licensed

See and control every machine from one dashboard.

Prometheus is a remote administration and monitoring platform. Drop a lightweight Python agent on any node and watch it stream live metrics to your dashboard over WebSockets — then send commands right back.

$git clone https://github.com/drzewkopl/Prometheus.git
Prometheus dashboard overview with a global agent map, connected agents, a system health chart and network topology summary
Real-timeLive telemetry over persistent WebSockets
Agent-basedOne Python process per monitored node
Cross-platformmacOS, Linux and Windows via psutil
Self-hostedYour server, your data, JWT-secured
Architecture

Three pieces, one live loop.

Agents push system state to a central FastAPI server; the dashboard subscribes and dispatches commands. Everything travels over WebSockets, so updates land the moment they happen.

Web dashboard

A React + TypeScript frontend for overview maps, charts, consoles and alert management.

ReactTypeScriptViteTailwind

FastAPI server

REST API and WebSocket hub. Handles auth, agent registration, alert rules and command routing.

FastAPISQLAlchemyJWTUvicorn

Python agents

Lightweight collectors on each node. Report metrics, run commands and stream output back.

Python 3.9+psutilwebsockets
Features

Everything you need to keep an eye on your fleet.

From a single laptop to a scattered set of servers — monitor, compare, diagnose and act without SSH-hopping between machines.

Live system health

CPU, memory, disk, uptime, process count and latency per agent, streamed and charted in real time.

Global agent map

Agents geolocate themselves by WAN IP and appear on an interactive world map with their status.

Network topology

See agents grouped by network, with interfaces, bandwidth per NIC, open ports and active connections.

Compare agents

Put machines side by side to spot the outlier hogging resources before it becomes a problem.

Disk analyzer

Browse remote file systems, drill into directories and see what is eating space — with owner and permissions.

Command console

Dispatch commands to any agent and watch stdout/stderr stream back live. Tail remote log files too.

Alerts & rules

Define thresholds once; the alerts dashboard surfaces every breach across all connected nodes.

Network diagnostics

Run traceroutes, latency tests, Wi-Fi scans and service listings remotely, straight from the UI.

Clone agent tool

Duplicate an existing agent setup to onboard new machines quickly and consistently.

Overview

Your whole fleet at a glance.

The overview pulls together where your agents are, whether they are online, how healthy they are and which network they live on.

  • Live WebSocket connection status
  • Leaflet / OpenStreetMap agent map
  • CPU, memory, disk and latency in one chart
Dashboard overview screen of Prometheus
Disk analyzer

Find what is filling the disk.

Pick any online agent and explore its file system remotely. A donut chart breaks down the current directory; click through to drill deeper.

  • Navigate up, refresh and jump home
  • Per-entry size, type, owner and permissions
  • Works on macOS, Linux and Windows agents
Disk analyzer screen showing a directory usage donut chart and a list of directory contents
Quick start

Up and running in minutes.

You need Node.js with npm, and Python 3.9+ with pip. Then follow the steps — or use the one-command startup.

~/Prometheus

Clone the repository and install the frontend and Python dependencies.

git clone https://github.com/drzewkopl/Prometheus.git
cd Prometheus
npm install
pip3 install -r requirements.txt
Built with

A modern, familiar stack.

TypeScript React Vite Tailwind CSS Leaflet Python FastAPI SQLAlchemy WebSockets psutil

Ready to light the fire?

Prometheus is free and open source under the MIT license. Star the repo, try it on your machines, and contributions are welcome.