sysdock 1.1.0__tar.gz

sysdock-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 InfraVision
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sysdock-1.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include install.sh
+include SETUP_GUIDE.md
+recursive-include infravision_agent *.py

sysdock-1.1.0/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: sysdock
+Version: 1.1.0
+Summary: SysDock — Linux / EC2 monitoring agent with live terminal dashboard and Docker metrics
+License: MIT
+Project-URL: Homepage, https://github.com/your-org/sysdock
+Project-URL: Issues, https://github.com/your-org/sysdock/issues
+Keywords: monitoring,metrics,ec2,linux,devops,docker,sysadmin,sysdock
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psutil>=5.8.0
+Requires-Dist: rich>=12.0.0
+Requires-Dist: click>=7.0
+Provides-Extra: docker
+Requires-Dist: docker>=5.0.0; extra == "docker"
+Provides-Extra: server
+Requires-Dist: flask>=2.0; extra == "server"
+Provides-Extra: all
+Requires-Dist: docker>=5.0.0; extra == "all"
+Requires-Dist: flask>=2.0; extra == "all"
+Dynamic: license-file
+Dynamic: requires-python
+
+# SysDock
+
+**Linux / EC2 monitoring agent** with a live terminal dashboard, accurate Docker metrics, and a pip-installable CLI.
+
+```bash
+pip install sysdock
+sysdock          # opens the live dashboard — like htop, but more
+```
+
+---
+
+## Features
+
+- 🖥 **Live terminal dashboard** — CPU per-core, RAM, disk, network, processes, Docker, security
+- 🐳 **Accurate Docker metrics** — CPU %, memory, network I/O per container (matches `docker stats`)
+- 📊 **htop-accurate readings** — CPU sampled at 1s interval; RAM uses htop's exact formula
+- 🌐 **HTTP metrics API** — JSON snapshot + live SSE stream on one port
+- 🔒 **Security panel** — Falco events, SSH failures, fail2ban status
+- ⚡ **Zero config** — works on any Linux distro, Python 3.6+
+
+---
+
+## Install
+
+```bash
+# From PyPI
+pip install sysdock
+
+# With Docker SDK (richer container stats)
+pip install "sysdock[docker]"
+
+# With everything
+pip install "sysdock[all]"
+
+# From source
+git clone https://github.com/Kavyvachhani/SysDock.git
+cd SysDock
+pip install -e .
+```
+
+---
+
+## Quick Start
+
+```bash
+sysdock              # open live dashboard (default — no subcommand needed)
+sysdock dash         # same as above
+sysdock start        # start metrics HTTP server on :5010
+sysdock status       # one-shot snapshot (rich table)
+sysdock status --json               # raw JSON
+sysdock status --section docker     # Docker only
+sysdock check        # verify all dependencies
+```
+
+### On EC2 — one-step install
+```bash
+sudo bash install.sh          # auto-installs Python, pip, sysdock + systemd service
+```
+
+---
+
+## HTTP API
+
+```bash
+curl http://localhost:5010/health
+curl http://localhost:5010/
+curl -N http://localhost:5010/stream   # live SSE stream
+```
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /` | Full JSON snapshot — all metrics |
+| `GET /stream` | Server-Sent Events — pushes every 5s |
+| `GET /health` | `{"status": "ok"}` |
+
+---
+
+## Metric Accuracy
+
+| Metric | Method |
+|--------|--------|
+| CPU % | 1-second sampling (matches htop) |
+| RAM used | `total − free − buffers − cached` (htop formula) |
+| Docker CPU | `(cpu_delta / sys_delta) × nCPUs × 100` (matches `docker stats`) |
+| Docker memory | Subtracts `inactive_file` (cgroups v2) / `cache` (cgroups v1) |
+
+---
+
+## CLI Reference
+
+```
+sysdock             → live dashboard (default)
+sysdock dash        → live dashboard (with --refresh option)
+sysdock start       → HTTP metrics server [--port 5010] [--host 0.0.0.0]
+sysdock status      → snapshot [--section system|disk|processes|network|docker|security|all] [--json]
+sysdock check       → dependency check
+sysdock install     → systemd service (requires root)
+sysdock uninstall   → remove service (requires root)
+sysdock --version   → 1.1.0
+```
+
+---
+
+## Project Structure
+
+```
+SysDock/
+├── pyproject.toml              pip package config (entry point: sysdock)
+├── setup.py                    legacy pip fallback
+├── MANIFEST.in
+├── install.sh                  one-step Linux installer
+├── test_sysdock.py             self-test suite
+├── SETUP_GUIDE.md              full setup + PyPI publishing guide
+├── EC2_DEPLOY_GUIDE.md         EC2 transfer + test + deploy guide
+└── infravision_agent/
+    ├── cli.py                  sysdock CLI (auto-launches dashboard)
+    ├── server.py               HTTP server on port 5010
+    ├── collectors/
+    │   ├── system.py           CPU / RAM / load / uptime
+    │   ├── disk.py             partitions + I/O
+    │   ├── processes.py        top processes
+    │   ├── network.py          interfaces + connections
+    │   ├── docker_collector.py container stats (SDK + CLI fallback)
+    │   └── security.py         Falco / SSH / fail2ban
+    └── display/
+        └── dashboard.py        Rich live TUI dashboard
+```
+
+---
+
+## Compatibility
+
+| Distro | Status |
+|--------|--------|
+| Ubuntu 20.04 / 22.04 / 24.04 | ✅ |
+| Debian 10 / 11 / 12 | ✅ |
+| Amazon Linux 2 / 2023 | ✅ |
+| CentOS 7 / Stream 8 / 9 | ✅ |
+| RHEL 7 / 8 / 9 | ✅ |
+| Alpine Linux | ✅ |
+| Arch Linux | ✅ |
+
+**Python 3.6 – 3.12.** Requires Linux `/proc` filesystem.
+
+---
+
+## Security Note
+
+When exposing the HTTP API, restrict port 5010 to your monitoring server only:
+
+```bash
+aws ec2 authorize-security-group-ingress \
+  --group-id sg-xxxxxxxxxx \
+  --protocol tcp --port 5010 \
+  --cidr <monitoring-server-ip>/32
+```
+
+---
+
+## License
+
+MIT © 2026 [Kavyvachhani](https://github.com/Kavyvachhani)

sysdock-1.1.0/README.md

@@ -0,0 +1,162 @@
+# SysDock
+
+**Linux / EC2 monitoring agent** with a live terminal dashboard, accurate Docker metrics, and a pip-installable CLI.
+
+```bash
+pip install sysdock
+sysdock          # opens the live dashboard — like htop, but more
+```
+
+---
+
+## Features
+
+- 🖥 **Live terminal dashboard** — CPU per-core, RAM, disk, network, processes, Docker, security
+- 🐳 **Accurate Docker metrics** — CPU %, memory, network I/O per container (matches `docker stats`)
+- 📊 **htop-accurate readings** — CPU sampled at 1s interval; RAM uses htop's exact formula
+- 🌐 **HTTP metrics API** — JSON snapshot + live SSE stream on one port
+- 🔒 **Security panel** — Falco events, SSH failures, fail2ban status
+- ⚡ **Zero config** — works on any Linux distro, Python 3.6+
+
+---
+
+## Install
+
+```bash
+# From PyPI
+pip install sysdock
+
+# With Docker SDK (richer container stats)
+pip install "sysdock[docker]"
+
+# With everything
+pip install "sysdock[all]"
+
+# From source
+git clone https://github.com/Kavyvachhani/SysDock.git
+cd SysDock
+pip install -e .
+```
+
+---
+
+## Quick Start
+
+```bash
+sysdock              # open live dashboard (default — no subcommand needed)
+sysdock dash         # same as above
+sysdock start        # start metrics HTTP server on :5010
+sysdock status       # one-shot snapshot (rich table)
+sysdock status --json               # raw JSON
+sysdock status --section docker     # Docker only
+sysdock check        # verify all dependencies
+```
+
+### On EC2 — one-step install
+```bash
+sudo bash install.sh          # auto-installs Python, pip, sysdock + systemd service
+```
+
+---
+
+## HTTP API
+
+```bash
+curl http://localhost:5010/health
+curl http://localhost:5010/
+curl -N http://localhost:5010/stream   # live SSE stream
+```
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /` | Full JSON snapshot — all metrics |
+| `GET /stream` | Server-Sent Events — pushes every 5s |
+| `GET /health` | `{"status": "ok"}` |
+
+---
+
+## Metric Accuracy
+
+| Metric | Method |
+|--------|--------|
+| CPU % | 1-second sampling (matches htop) |
+| RAM used | `total − free − buffers − cached` (htop formula) |
+| Docker CPU | `(cpu_delta / sys_delta) × nCPUs × 100` (matches `docker stats`) |
+| Docker memory | Subtracts `inactive_file` (cgroups v2) / `cache` (cgroups v1) |
+
+---
+
+## CLI Reference
+
+```
+sysdock             → live dashboard (default)
+sysdock dash        → live dashboard (with --refresh option)
+sysdock start       → HTTP metrics server [--port 5010] [--host 0.0.0.0]
+sysdock status      → snapshot [--section system|disk|processes|network|docker|security|all] [--json]
+sysdock check       → dependency check
+sysdock install     → systemd service (requires root)
+sysdock uninstall   → remove service (requires root)
+sysdock --version   → 1.1.0
+```
+
+---
+
+## Project Structure
+
+```
+SysDock/
+├── pyproject.toml              pip package config (entry point: sysdock)
+├── setup.py                    legacy pip fallback
+├── MANIFEST.in
+├── install.sh                  one-step Linux installer
+├── test_sysdock.py             self-test suite
+├── SETUP_GUIDE.md              full setup + PyPI publishing guide
+├── EC2_DEPLOY_GUIDE.md         EC2 transfer + test + deploy guide
+└── infravision_agent/
+    ├── cli.py                  sysdock CLI (auto-launches dashboard)
+    ├── server.py               HTTP server on port 5010
+    ├── collectors/
+    │   ├── system.py           CPU / RAM / load / uptime
+    │   ├── disk.py             partitions + I/O
+    │   ├── processes.py        top processes
+    │   ├── network.py          interfaces + connections
+    │   ├── docker_collector.py container stats (SDK + CLI fallback)
+    │   └── security.py         Falco / SSH / fail2ban
+    └── display/
+        └── dashboard.py        Rich live TUI dashboard
+```
+
+---
+
+## Compatibility
+
+| Distro | Status |
+|--------|--------|
+| Ubuntu 20.04 / 22.04 / 24.04 | ✅ |
+| Debian 10 / 11 / 12 | ✅ |
+| Amazon Linux 2 / 2023 | ✅ |
+| CentOS 7 / Stream 8 / 9 | ✅ |
+| RHEL 7 / 8 / 9 | ✅ |
+| Alpine Linux | ✅ |
+| Arch Linux | ✅ |
+
+**Python 3.6 – 3.12.** Requires Linux `/proc` filesystem.
+
+---
+
+## Security Note
+
+When exposing the HTTP API, restrict port 5010 to your monitoring server only:
+
+```bash
+aws ec2 authorize-security-group-ingress \
+  --group-id sg-xxxxxxxxxx \
+  --protocol tcp --port 5010 \
+  --cidr <monitoring-server-ip>/32
+```
+
+---
+
+## License
+
+MIT © 2026 [Kavyvachhani](https://github.com/Kavyvachhani)

sysdock-1.1.0/SETUP_GUIDE.md

@@ -0,0 +1,297 @@
+# SysDock — Setup Guide
+
+**SysDock** is a lightweight Linux monitoring agent with a live terminal dashboard, Docker metrics, and a pip-installable CLI command.
+
+---
+
+## Table of Contents
+1. [Prerequisites](#1-prerequisites)
+2. [Install Locally from Source](#2-install-locally-from-source)
+3. [Using SysDock](#3-using-sysdock)
+4. [Install Docker Support](#4-install-docker-support)
+5. [Build a Distributable Package](#5-build-a-distributable-package)
+6. [Publish to PyPI](#6-publish-to-pypi)
+7. [Install as a Systemd Service](#7-install-as-a-systemd-service)
+8. [One-Step Linux Installer Script](#8-one-step-linux-installer-script)
+9. [Uninstall](#9-uninstall)
+10. [CLI Reference](#10-cli-reference)
+
+---
+
+## 1. Prerequisites
+
+| Requirement | Version |
+|-------------|---------|
+| Python      | 3.6+    |
+| pip         | 21+     |
+| Linux       | Any distribution with `/proc` filesystem |
+| Docker      | Optional — enables live container stats |
+
+Check your Python version:
+```bash
+python3 --version
+```
+
+---
+
+## 2. Install Locally from Source
+
+### Step 1 — Clone or copy the project
+```bash
+# If you have git:
+git clone https://github.com/your-org/sysdock.git
+cd sysdock
+
+# Or unzip / copy the project folder and cd into it:
+cd infravision-agent
+```
+
+### Step 2 — (Optional) Create a virtual environment
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+```
+
+### Step 3 — Install in editable (development) mode
+```bash
+pip install -e .
+```
+
+This registers the `sysdock` command in your PATH. You can now run:
+```bash
+sysdock
+```
+
+### Step 4 — Install with all optional dependencies
+```bash
+# With Docker SDK support (recommended):
+pip install -e ".[docker]"
+
+# With everything (Docker + Flask server):
+pip install -e ".[all]"
+```
+
+---
+
+## 3. Using SysDock
+
+### Open the live dashboard (default)
+```bash
+sysdock
+```
+Just type `sysdock` and press Enter — the live dashboard opens immediately, like htop.
+
+### Open the dashboard explicitly
+```bash
+sysdock dash
+sysdock dash --refresh 2   # refresh every 2 seconds (default: 3)
+```
+
+### One-shot status snapshot
+```bash
+sysdock status             # pretty table output
+sysdock status --json      # raw JSON
+sysdock status --section cpu       # only CPU section
+sysdock status --section docker    # only Docker
+```
+Available sections: `system`, `disk`, `processes`, `network`, `docker`, `security`, `all`
+
+### Start the metrics HTTP server
+```bash
+sysdock start                       # default: 0.0.0.0:5010
+sysdock start --port 8080           # custom port
+sysdock start --host 127.0.0.1     # localhost only
+
+# Query the API:
+curl http://localhost:5010/
+curl http://localhost:5010/health
+curl -N http://localhost:5010/stream   # live JSON stream
+```
+
+### Check all dependencies
+```bash
+sysdock check
+```
+
+---
+
+## 4. Install Docker Support
+
+Install the `docker-py` SDK for richer container metrics (CPU, memory, network I/O):
+```bash
+pip install "docker>=5.0.0"
+```
+
+Without the SDK, SysDock falls back to the `docker` CLI automatically — both give accurate stats.
+
+To verify Docker is detected:
+```bash
+sysdock check           # "Docker daemon" row should show "running"
+sysdock status --section docker
+```
+
+---
+
+## 5. Build a Distributable Package
+
+### Step 1 — Install the build tool
+```bash
+pip install build
+```
+
+### Step 2 — Build wheel + sdist
+```bash
+cd /path/to/infravision-agent    # project root (contains pyproject.toml)
+python -m build
+```
+
+Output files will be in the `dist/` directory:
+```
+dist/
+  sysdock-1.1.0.tar.gz        # source distribution
+  sysdock-1.1.0-py3-none-any.whl  # wheel
+```
+
+### Step 3 — Install from the wheel
+```bash
+pip install dist/sysdock-1.1.0-py3-none-any.whl
+```
+
+### Step 4 — Verify
+```bash
+sysdock --version    # should print: SysDock, version 1.1.0
+sysdock check
+```
+
+---
+
+## 6. Publish to PyPI
+
+### Step 1 — Create a PyPI account
+Register at https://pypi.org/account/register/
+
+### Step 2 — Install Twine
+```bash
+pip install twine
+```
+
+### Step 3 — Build the package
+```bash
+python -m build
+```
+
+### Step 4 — Upload to TestPyPI first (recommended)
+```bash
+twine upload --repository testpypi dist/*
+```
+
+Test install from TestPyPI:
+```bash
+pip install --index-url https://test.pypi.org/simple/ sysdock
+sysdock --version
+```
+
+### Step 5 — Upload to real PyPI
+```bash
+twine upload dist/*
+```
+
+### Step 6 — Anyone can now install with:
+```bash
+pip install sysdock
+pip install "sysdock[docker]"    # with Docker SDK
+```
+
+---
+
+## 7. Install as a Systemd Service
+
+Run as a persistent background service that auto-starts on boot:
+
+```bash
+sudo sysdock install                  # uses default port 5010
+sudo sysdock install --port 8080      # custom port
+```
+
+Service management commands:
+```bash
+sudo systemctl status  sysdock
+sudo systemctl restart sysdock
+sudo systemctl stop    sysdock
+sudo journalctl -u sysdock -f          # live logs
+```
+
+---
+
+## 8. One-Step Linux Installer Script
+
+The `install.sh` script handles everything automatically (Python, pip, sysdock, systemd service, firewall):
+
+```bash
+sudo bash install.sh                   # default port 5010
+sudo bash install.sh --port 8080       # custom port
+sudo bash install.sh --falco           # also install Falco security
+sudo bash install.sh --no-service      # skip systemd registration
+```
+
+After installation:
+```bash
+sysdock                                # open live dashboard
+curl http://localhost:5010/            # access metrics API
+```
+
+---
+
+## 9. Uninstall
+
+```bash
+# Remove systemd service:
+sudo sysdock uninstall
+
+# Uninstall pip package:
+pip uninstall sysdock
+
+# Or using the install script:
+sudo bash install.sh --uninstall
+```
+
+---
+
+## 10. CLI Reference
+
+```
+Usage: sysdock [OPTIONS] COMMAND [ARGS]...
+
+  SysDock — Linux / EC2 monitoring agent.
+  Type 'sysdock' (no command) to open the live dashboard.
+
+Options:
+  --version   Show version and exit.
+  --help      Show this message and exit.
+
+Commands:
+  dash        Open the live terminal dashboard (Ctrl+C to exit)
+  start       Start the metrics HTTP server
+  status      Print a one-shot status snapshot
+  check       Verify all dependencies and system capabilities
+  install     Install SysDock as a systemd service (requires root)
+  uninstall   Remove the SysDock systemd service (requires root)
+```
+
+### Metrics HTTP API
+
+| Endpoint        | Description                               |
+|-----------------|-------------------------------------------|
+| `GET /`         | Full JSON snapshot of all metrics         |
+| `GET /health`   | Simple health check `{"status": "ok"}`    |
+| `GET /stream`   | Newline-delimited live JSON stream        |
+| `GET /metrics`  | Prometheus-compatible text format         |
+
+---
+
+## Notes on Metric Accuracy
+
+- **CPU%** is measured with a 1-second sampling interval, matching htop's default method.
+- **Memory used** = `total − free − buffers − cached (+ SReclaimable)` — this is the htop formula.
+- **Docker CPU%** uses the same calculation as `docker stats`: `(cpu_delta / sys_delta) × nCPUs × 100`.
+- **Docker memory** subtracts the page cache (`inactive_file` on cgroups v2, `cache` on cgroups v1), matching `docker stats` output exactly.

sysdock-1.1.0/infravision_agent/__init__.py

@@ -0,0 +1,2 @@
+# infravision_agent package
+__version__ = "1.0.0"

sysdock-1.1.0/infravision_agent/__main__.py

@@ -0,0 +1,7 @@
+"""Allow running as: python3 -m infravision_agent [command]
+Running without a command argument launches the dashboard automatically.
+"""
+from infravision_agent.cli import main
+
+if __name__ == "__main__":
+    main()