feat: Implement core engine for system orchestration and secure, multi-file transfer with progress tracking.

Author: radikonreturn

.gitignore

@@ -99,6 +99,7 @@ celerybeat.pid
 *.sage.py
 
 # --- Package Managers ---
+node_modules/
 # Pipfile.lock
 # uv.lock
 # poetry.lock

README.md

@@ -34,7 +34,15 @@ Mesh-Pulse turns your terminal into a **Command Center** for your local network.
 
 ### 1. Installation
 
-Mesh-Pulse requires **Python 3.10+**. Clone the repository and install the dependencies:
+**Via NPM (Recommended)**
+You can easily install and run Mesh-Pulse globally using NPM:
+
+```bash
+npm install -g mesh-pulse
+```
+
+**Via Git (For Development)**
+Alternatively, clone the repository and install the Python dependencies directly:
 
 ```bash
 git clone https://github.com/radikonreturn/mesh_pulse.git
@@ -44,15 +52,28 @@ pip install -r requirements.txt
 
 ### 2. Running the Dashboard
 
-Start the application with default settings:
+If you installed via NPM globally, you can start the dashboard from anywhere:
+
+```bash
+mesh-pulse
+```
+
+Alternatively, you can run it via `npx` without installing:
+
+```bash
+npx mesh-pulse
+```
+
+**Running from Source (Python)**
+If you are running from the cloned repository:
 
 ```bash
 python -m mesh_pulse
 ```
 
-For advanced configuration, you can pass custom port settings:
+For advanced configuration, you can pass custom port settings (works identically for `mesh-pulse` and `python -m mesh_pulse`):
 ```bash
-python -m mesh_pulse --broadcast-port 9999 --transfer-port 10000
+mesh-pulse --broadcast-port 9999 --transfer-port 10000
 ```
 
 ---

bin/install.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+const { execSync, spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const venvPath = path.join(__dirname, '..', '.venv');
+const reqPath = path.join(__dirname, '..', 'requirements.txt');
+
+try {
+    if (!fs.existsSync(venvPath)) {
+        console.log('Creating Python virtual environment...');
+        // Try python3 first, fallback to python
+        try {
+            execSync('python3 -m venv .venv', {
+                cwd: path.join(__dirname, '..'),
+                stdio: 'inherit'
+            });
+        } catch (e) {
+            execSync('python -m venv .venv', {
+                cwd: path.join(__dirname, '..'),
+                stdio: 'inherit'
+            });
+        }
+    } else {
+        console.log('Python virtual environment already exists.');
+    }
+
+    const pipCmd = process.platform === 'win32'
+        ? path.join(venvPath, 'Scripts', 'pip')
+        : path.join(venvPath, 'bin', 'pip');
+
+    console.log('Installing Python dependencies...');
+    const pipArgs = ['install', '-r', reqPath];
+    const result = spawnSync(pipCmd, pipArgs, {
+        cwd: path.join(__dirname, '..'),
+        stdio: 'inherit'
+    });
+
+    if (result.error || result.status !== 0) {
+        throw new Error(`pip install failed with status ${result.status}`);
+    }
+    console.log('Installation complete.');
+} catch (error) {
+    console.error('Failed to setup Python environment:', error.message);
+    process.exit(1);
+}

bin/run.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const venvPath = path.join(__dirname, '..', '.venv');
+const pythonCmd = process.platform === 'win32'
+    ? path.join(venvPath, 'Scripts', 'python')
+    : path.join(venvPath, 'bin', 'python');
+
+if (!fs.existsSync(pythonCmd)) {
+    console.error(`Error: Python executable not found at ${pythonCmd}`);
+    console.error('The virtual environment may not have been created correctly.');
+    console.error('Try running: npm run postinstall');
+    process.exit(1);
+}
+
+const args = ['-m', 'mesh_pulse', ...process.argv.slice(2)];
+
+// TUI apps need stdin, stdout, and stderr as raw context usually. 
+// stdio: "inherit" passes through perfectly to Textual/Rich.
+const result = spawnSync(pythonCmd, args, {
+    cwd: process.cwd(),
+    stdio: 'inherit'
+});
+
+if (result.error) {
+    console.error(`Failed to launch mesh_pulse: ${result.error.message}`);
+    process.exit(1);
+}
+
+process.exit(result.status !== null ? result.status : 1);

package.json

@@ -0,0 +1,31 @@
+{
+    "name": "mesh-pulse",
+    "version": "1.0.0",
+    "description": "A TUI-based Network Mesh & System Resource Monitor",
+    "main": "bin/run.js",
+    "bin": {
+        "mesh-pulse": "./bin/run.js"
+    },
+    "scripts": {
+        "postinstall": "node bin/install.js"
+    },
+    "keywords": [
+        "tui",
+        "network",
+        "mesh",
+        "monitor",
+        "python",
+        "textual"
+    ],
+    "author": "Mesh-Pulse Team",
+    "license": "MIT",
+    "dependencies": {},
+    "files": [
+        "bin",
+        "mesh_pulse",
+        "requirements.txt",
+        "pyproject.toml",
+        "README.md",
+        "LICENSE"
+    ]
+}