vpspilot 1.0.0__tar.gz

vpspilot-1.0.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: vpspilot
+Version: 1.0.0
+Summary: VPSPilot: The Autonomous Next-Gen VPS Command Center & Online Management Dashboard
+Author: Technology Innovision Team
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/technologyinnovision-team/VPSPILOT
+Project-URL: Documentation, https://github.com/technologyinnovision-team/VPSPILOT#readme
+Project-URL: Repository, https://github.com/technologyinnovision-team/VPSPILOT.git
+Project-URL: Bug Tracker, https://github.com/technologyinnovision-team/VPSPILOT/issues
+Keywords: vps,dashboard,terminal,web-terminal,systemd,server-management,monitoring,telemetry,cloud
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: psutil>=5.8.0
+Dynamic: requires-python
+
+# ⚡ VPSPilot: Precision VPS Management Deck & Web Command Center
+
+**VPSPilot** is an autonomous, production-grade Python package and web dashboard engineered specifically for Linux Virtual Private Servers (VPS). It equips VPS owners and sysadmins with an online command center for host configuration, real-time hardware telemetry, full-duplex interactive web terminal, and complete systemd service management.
+
+---
+
+## 🌟 Key Capabilities
+
+- 📊 **Real-Time Telemetry**: Live per-core CPU utilization, RAM usage, swap space, mounted filesystem quotas, and live RX/TX network transfer rates.
+- 💻 **Interactive Web Terminal**: Full-featured web shell powered by `xterm.js` and `/dev/pts` pseudo-terminals with resize detection (`TIOCSWINSZ`), ANSI colors, and shortcut toolbar (Ctrl+C, Ctrl+D, Clear, Reconnect).
+- ⚙️ **All Services Manager**: Real-time listing of all systemd units with state filters (`active`, `inactive`, `failed`), one-click controls (Start, Stop, Restart), and an integrated Journalctl log inspector modal.
+- 🛠️ **VPS Configuration Deck**:
+  - Hostname changer (`hostnamectl`)
+  - Timezone selector (`timedatectl`)
+  - DNS resolvers viewer (`/etc/resolv.conf`)
+  - SSH daemon security inspection (Port, Root Login, Password Auth)
+  - Firewall manager (UFW rules: Allow/Deny, rule removal, enable/disable toggle)
+  - System maintenance (package update status, cache cleanup, safe Reboot/Poweroff)
+- 🗂️ **Process Explorer**: Live running processes list sorted by CPU% or Memory% with instant `SIGTERM` / `SIGKILL` signals.
+- 🔒 **Enterprise-Grade Security**: PBKDF2-HMAC-SHA256 password hashing, secure session tokens, rate-limited login defense, and strict permission enforcement (`0600` on credentials).
+- 📦 **Offline-Ready & Zero CDN Dependency**: `xterm.js` and vendor assets are bundled inside the Python package, ensuring the terminal functions flawlessly on isolated or restricted networks.
+
+---
+
+## 🚀 Installation
+
+### Global Install via pip
+```bash
+pip install --break-system-packages .
+```
+
+Or install in development/editable mode:
+```bash
+pip install --break-system-packages -e .
+```
+
+---
+
+## 🖥️ Command Line Usage
+
+Once installed, the global `vpspilot` executable is available anywhere:
+
+```bash
+# Start VPSPilot in foreground
+vpspilot start --port 8888
+
+# Start VPSPilot as a background daemon
+vpspilot start --port 8888 --daemon
+
+# Check daemon status
+vpspilot status
+
+# Stop daemon
+vpspilot stop
+
+# Restart daemon
+vpspilot restart
+
+# Change admin password
+vpspilot set-password
+
+# View current configuration
+vpspilot config show
+
+# Install as an automated systemd service (boots on server start)
+sudo vpspilot install-service
+
+# Uninstall systemd service
+sudo vpspilot uninstall-service
+```
+
+---
+
+## 🌐 Web Dashboard Access
+
+After launching, open your browser and navigate to:
+```
+http://<YOUR-VPS-IP>:8888
+```
+
+On first launch, an initial administrative password is automatically generated and printed to the terminal console if one has not been specified.
+
+---
+
+## 🏗️ Architecture
+
+```
+Client Browser (SPA)
+  │
+  ├── REST API (/api/*)  ──> aiohttp Web Server
+  ├── Telemetry WS (/ws/metrics) ──> psutil + /proc Kernel Telemetry
+  └── Web Terminal WS (/ws/terminal) ──> Python PTY Bridge (pty.openpty)
+                                              │
+                                              └── /dev/pts (bash/zsh login shell)
+```
+
+---
+
+## 📄 License
+Apache-2.0 / MIT. Crafted with precision for Linux VPS systems.

vpspilot-1.0.0/README.md

@@ -0,0 +1,100 @@
+# ⚡ VPSPilot: Precision VPS Management Deck & Web Command Center
+
+**VPSPilot** is an autonomous, production-grade Python package and web dashboard engineered specifically for Linux Virtual Private Servers (VPS). It equips VPS owners and sysadmins with an online command center for host configuration, real-time hardware telemetry, full-duplex interactive web terminal, and complete systemd service management.
+
+---
+
+## 🌟 Key Capabilities
+
+- 📊 **Real-Time Telemetry**: Live per-core CPU utilization, RAM usage, swap space, mounted filesystem quotas, and live RX/TX network transfer rates.
+- 💻 **Interactive Web Terminal**: Full-featured web shell powered by `xterm.js` and `/dev/pts` pseudo-terminals with resize detection (`TIOCSWINSZ`), ANSI colors, and shortcut toolbar (Ctrl+C, Ctrl+D, Clear, Reconnect).
+- ⚙️ **All Services Manager**: Real-time listing of all systemd units with state filters (`active`, `inactive`, `failed`), one-click controls (Start, Stop, Restart), and an integrated Journalctl log inspector modal.
+- 🛠️ **VPS Configuration Deck**:
+  - Hostname changer (`hostnamectl`)
+  - Timezone selector (`timedatectl`)
+  - DNS resolvers viewer (`/etc/resolv.conf`)
+  - SSH daemon security inspection (Port, Root Login, Password Auth)
+  - Firewall manager (UFW rules: Allow/Deny, rule removal, enable/disable toggle)
+  - System maintenance (package update status, cache cleanup, safe Reboot/Poweroff)
+- 🗂️ **Process Explorer**: Live running processes list sorted by CPU% or Memory% with instant `SIGTERM` / `SIGKILL` signals.
+- 🔒 **Enterprise-Grade Security**: PBKDF2-HMAC-SHA256 password hashing, secure session tokens, rate-limited login defense, and strict permission enforcement (`0600` on credentials).
+- 📦 **Offline-Ready & Zero CDN Dependency**: `xterm.js` and vendor assets are bundled inside the Python package, ensuring the terminal functions flawlessly on isolated or restricted networks.
+
+---
+
+## 🚀 Installation
+
+### Global Install via pip
+```bash
+pip install --break-system-packages .
+```
+
+Or install in development/editable mode:
+```bash
+pip install --break-system-packages -e .
+```
+
+---
+
+## 🖥️ Command Line Usage
+
+Once installed, the global `vpspilot` executable is available anywhere:
+
+```bash
+# Start VPSPilot in foreground
+vpspilot start --port 8888
+
+# Start VPSPilot as a background daemon
+vpspilot start --port 8888 --daemon
+
+# Check daemon status
+vpspilot status
+
+# Stop daemon
+vpspilot stop
+
+# Restart daemon
+vpspilot restart
+
+# Change admin password
+vpspilot set-password
+
+# View current configuration
+vpspilot config show
+
+# Install as an automated systemd service (boots on server start)
+sudo vpspilot install-service
+
+# Uninstall systemd service
+sudo vpspilot uninstall-service
+```
+
+---
+
+## 🌐 Web Dashboard Access
+
+After launching, open your browser and navigate to:
+```
+http://<YOUR-VPS-IP>:8888
+```
+
+On first launch, an initial administrative password is automatically generated and printed to the terminal console if one has not been specified.
+
+---
+
+## 🏗️ Architecture
+
+```
+Client Browser (SPA)
+  │
+  ├── REST API (/api/*)  ──> aiohttp Web Server
+  ├── Telemetry WS (/ws/metrics) ──> psutil + /proc Kernel Telemetry
+  └── Web Terminal WS (/ws/terminal) ──> Python PTY Bridge (pty.openpty)
+                                              │
+                                              └── /dev/pts (bash/zsh login shell)
+```
+
+---
+
+## 📄 License
+Apache-2.0 / MIT. Crafted with precision for Linux VPS systems.

vpspilot-1.0.0/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vpspilot"
+version = "1.0.0"
+description = "VPSPilot: The Autonomous Next-Gen VPS Command Center & Online Management Dashboard"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "Apache-2.0"
+authors = [
+    { name = "Technology Innovision Team" }
+]
+keywords = [
+    "vps",
+    "dashboard",
+    "terminal",
+    "web-terminal",
+    "systemd",
+    "server-management",
+    "monitoring",
+    "telemetry",
+    "cloud"
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: System Administrators",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: POSIX :: Linux",
+    "Topic :: System :: Systems Administration",
+    "Topic :: System :: Monitoring",
+    "Topic :: Terminals :: Terminal Emulators/X Terminals"
+]
+dependencies = [
+    "aiohttp>=3.8.0",
+    "psutil>=5.8.0"
+]
+
+[project.scripts]
+vpspilot = "vpspilot.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/technologyinnovision-team/VPSPILOT"
+Documentation = "https://github.com/technologyinnovision-team/VPSPILOT#readme"
+Repository = "https://github.com/technologyinnovision-team/VPSPILOT.git"
+"Bug Tracker" = "https://github.com/technologyinnovision-team/VPSPILOT/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["vpspilot*"]
+
+[tool.setuptools.package-data]
+vpspilot = [
+    "static/*",
+    "static/**/*",
+    "templates/*"
+]

vpspilot-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vpspilot-1.0.0/setup.py

@@ -0,0 +1,72 @@
+import os
+import sys
+import shutil
+import subprocess
+from setuptools import setup, find_packages
+from setuptools.command.install import install
+
+class CustomInstallCommand(install):
+    """Custom installation command that automatically sets up and starts the systemd service when run as root."""
+    def run(self):
+        super().run()
+        # If running on Linux as root with systemd available, auto-install and start the daemon
+        if os.name == "posix" and os.geteuid() == 0 and os.path.exists("/run/systemd/system"):
+            try:
+                vpspilot_bin = shutil.which("vpspilot") or f"{sys.executable} -m vpspilot.cli"
+                service_content = f"""[Unit]
+Description=VPSPilot - The Autonomous VPS Command Center
+After=network.target network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=/
+ExecStart={vpspilot_bin} start --host 0.0.0.0 --port 8888 --foreground
+Restart=always
+RestartSec=3
+LimitNOFILE=65536
+StandardOutput=journal
+StandardError=journal
+
+[Install]
+WantedBy=multi-user.target
+"""
+                service_path = "/etc/systemd/system/vpspilot.service"
+                with open(service_path, "w", encoding="utf-8") as f:
+                    f.write(service_content)
+                subprocess.run(["systemctl", "daemon-reload"], check=False)
+                subprocess.run(["systemctl", "enable", "--now", "vpspilot.service"], check=False)
+                print("\n[+] VPSPilot systemd service automatically installed & started! It will always run in the background.\n")
+            except Exception as e:
+                print(f"\n[!] Note: To enable always-running background service, run: sudo vpspilot install-service ({e})\n")
+
+setup(
+    name="vpspilot",
+    version="1.0.0",
+    description="VPSPilot: The Autonomous Next-Gen VPS Command Center & Online Management Dashboard",
+    packages=find_packages(),
+    include_package_data=True,
+    package_data={
+        "vpspilot": [
+            "static/*",
+            "static/css/*",
+            "static/js/*",
+            "static/vendor/*",
+            "templates/*"
+        ]
+    },
+    install_requires=[
+        "aiohttp>=3.8.0",
+        "psutil>=5.8.0"
+    ],
+    entry_points={
+        "console_scripts": [
+            "vpspilot=vpspilot.cli:main"
+        ]
+    },
+    cmdclass={
+        "install": CustomInstallCommand
+    },
+    python_requires=">=3.9"
+)

vpspilot-1.0.0/tests/test_auth.py

@@ -0,0 +1,32 @@
+import unittest
+from vpspilot.config import hash_password, verify_password
+from vpspilot.system.auth import create_session, validate_session, destroy_session, is_rate_limited, record_attempt
+
+class TestAuth(unittest.TestCase):
+    def test_password_hashing_and_verification(self):
+        pwd = "SuperSecretPassword123!"
+        hashed, salt = hash_password(pwd)
+        self.assertTrue(len(hashed) > 0)
+        self.assertTrue(len(salt) > 0)
+
+        # Valid password
+        self.assertTrue(verify_password(pwd, hashed, salt))
+
+        # Invalid password
+        self.assertFalse(verify_password("WrongPassword", hashed, salt))
+
+    def test_session_lifecycle(self):
+        token = create_session("admin", "127.0.0.1", ttl=60)
+        self.assertTrue(validate_session(token))
+        destroy_session(token)
+        self.assertFalse(validate_session(token))
+
+    def test_rate_limiting(self):
+        test_ip = "192.168.99.99"
+        self.assertFalse(is_rate_limited(test_ip))
+        for _ in range(12):
+            record_attempt(test_ip)
+        self.assertTrue(is_rate_limited(test_ip))
+
+if __name__ == "__main__":
+    unittest.main()

vpspilot-1.0.0/tests/test_metrics.py

@@ -0,0 +1,53 @@
+import unittest
+from vpspilot.system.metrics import (
+    get_system_info,
+    get_cpu_metrics,
+    get_memory_metrics,
+    get_disk_metrics,
+    get_network_metrics,
+    get_telemetry_snapshot
+)
+
+class TestMetrics(unittest.TestCase):
+    def test_system_info(self):
+        info = get_system_info()
+        self.assertIn("hostname", info)
+        self.assertIn("os", info)
+        self.assertIn("kernel", info)
+        self.assertIn("uptime_seconds", info)
+        self.assertGreater(info["uptime_seconds"], 0)
+
+    def test_cpu_metrics(self):
+        cpu = get_cpu_metrics()
+        self.assertIn("total_percent", cpu)
+        self.assertIn("cores", cpu)
+        self.assertIn("core_count", cpu)
+        self.assertGreater(cpu["core_count"], 0)
+        self.assertIsInstance(cpu["cores"], list)
+
+    def test_memory_metrics(self):
+        mem = get_memory_metrics()
+        self.assertIn("ram", mem)
+        self.assertIn("swap", mem)
+        self.assertIn("total", mem["ram"])
+        self.assertIn("percent", mem["ram"])
+        self.assertGreater(mem["ram"]["total"], 0)
+
+    def test_disk_metrics(self):
+        disks = get_disk_metrics()
+        self.assertIsInstance(disks, list)
+        self.assertGreater(len(disks), 0)
+        root = disks[0]
+        self.assertIn("mountpoint", root)
+        self.assertIn("total", root)
+
+    def test_telemetry_snapshot(self):
+        snapshot = get_telemetry_snapshot()
+        self.assertIn("system", snapshot)
+        self.assertIn("cpu", snapshot)
+        self.assertIn("memory", snapshot)
+        self.assertIn("disks", snapshot)
+        self.assertIn("network", snapshot)
+
+if __name__ == "__main__":
+    unittest.main()

vpspilot-1.0.0/tests/test_services.py

@@ -0,0 +1,28 @@
+import unittest
+from vpspilot.system.services import sanitize_service_name, list_services, control_service
+
+class TestServices(unittest.TestCase):
+    def test_sanitize_service_name(self):
+        self.assertEqual(sanitize_service_name("cron"), "cron.service")
+        self.assertEqual(sanitize_service_name("ssh.service"), "ssh.service")
+        self.assertEqual(sanitize_service_name("user@1000.service"), "user@1000.service")
+
+        with self.assertRaises(ValueError):
+            sanitize_service_name("cron; rm -rf /")
+
+    def test_list_services(self):
+        services = list_services()
+        self.assertIsInstance(services, list)
+        self.assertGreater(len(services), 0)
+        first = services[0]
+        self.assertIn("name", first)
+        self.assertIn("active", first)
+        self.assertIn("sub", first)
+
+    def test_disallowed_service_action(self):
+        res = control_service("cron", "destroy_everything")
+        self.assertFalse(res["success"])
+        self.assertIn("not permitted", res["error"])
+
+if __name__ == "__main__":
+    unittest.main()

vpspilot-1.0.0/vpspilot/__init__.py

@@ -0,0 +1,6 @@
+"""
+VPSPilot: The Modern Autonomous VPS Command Center & Online Dashboard
+"""
+
+__version__ = "1.0.0"
+__author__ = "Google DeepMind Antigravity Team"