vortix 1.2.0 → 1.2.2

package/README.md

@@ -1,20 +1,20 @@
 # Vortix
 
-🚀 **AI-powered remote OS control system** with natural language command
-execution, real-time monitoring, and advanced device management.
+AI-powered remote OS control system with natural language command execution,
+real-time monitoring, and advanced device management.
 
-## ✨ Features
+## Features
 
-- 🤖 **AI Command Generation** - Natural language to system commands
-- 📊 **Real-time System Monitoring** - CPU, Memory, Disk usage
-- 🖥️ **Screen Sharing** - Live desktop streaming
-- 📁 **File Transfer** - Upload/download files remotely
-- 🔄 **Multi-device Control** - Execute commands across multiple devices
-- 🔐 **Secure Authentication** - Password-protected device access
-- ⚡ **Auto-start on Boot** - Automatic agent startup
-- 📱 **Modern Web Dashboard** - Responsive UI with mobile support
+- **AI Command Generation** - Convert natural language to system commands
+- **Real-time System Monitoring** - CPU, Memory, and Disk usage tracking
+- **Screen Sharing** - Live desktop streaming capabilities
+- **File Transfer** - Upload and download files remotely
+- **Multi-device Control** - Execute commands across multiple devices
+- **Secure Authentication** - Password-protected device access
+- **Auto-start on Boot** - Automatic agent startup
+- **Modern Web Dashboard** - Responsive UI with mobile support
 
-## 🚀 Quick Start
+## Quick Start
 
 ### Installation
 
@@ -41,7 +41,7 @@ vortix start
 
 That's it! No backend setup required - everything runs in the cloud.
 
-## 📋 Commands
+## Commands
 
 | Command        | Description                           |
 | -------------- | ------------------------------------- |
@@ -49,7 +49,7 @@ That's it! No backend setup required - everything runs in the cloud.
 | `vortix start` | Start the agent on current machine    |
 | `vortix help`  | Show help information                 |
 
-## 🎯 Use Cases
+## Use Cases
 
 - **Remote Work** - Control your office computer from home
 - **Server Management** - Monitor and manage remote servers
@@ -57,14 +57,14 @@ That's it! No backend setup required - everything runs in the cloud.
 - **Home Automation** - Control your home PC from anywhere
 - **Development** - Manage multiple development environments
 
-## 🏗️ Architecture
+## Architecture
 
-- **☁️ Cloud Backend** - Hosted WebSocket server (always online)
-- **🤖 Local Agent** - Runs on your devices, executes commands
-- **🌐 Web Dashboard** - Modern React/Next.js interface
-- **🔒 Secure Connection** - End-to-end encrypted communication
+- **Cloud Backend** - Hosted WebSocket server (always online)
+- **Local Agent** - Runs on your devices, executes commands
+- **Web Dashboard** - Modern React/Next.js interface
+- **Secure Connection** - End-to-end encrypted communication
 
-## 💡 Example Commands
+## Example Commands
 
 Try these natural language commands in the dashboard:
 
@@ -77,7 +77,7 @@ Try these natural language commands in the dashboard:
 "check disk space"
 ```
 
-## 🔧 Advanced Features
+## Advanced Features
 
 ### Auto-start on Boot
 
@@ -99,7 +99,7 @@ Upload and download files directly through the web interface.
 
 Execute the same command across multiple connected devices simultaneously.
 
-## 🌐 Dashboard Features
+## Dashboard Features
 
 - **Command Center** - Execute commands with AI assistance
 - **Device Management** - View and control all connected devices
@@ -108,20 +108,20 @@ Execute the same command across multiple connected devices simultaneously.
 - **Screen Viewer** - Live desktop streaming
 - **Mobile Support** - Full functionality on mobile devices
 
-## 🔒 Security
+## Security
 
 - Password-protected device authentication
 - Secure WebSocket connections (WSS)
 - Command approval system for dangerous operations
 - No data stored on servers (commands executed locally)
 
-## 📱 Supported Platforms
+## Supported Platforms
 
-- ✅ Windows (7, 8, 10, 11)
-- ✅ macOS (10.14+)
-- ✅ Linux (Ubuntu, CentOS, Debian, etc.)
+- Windows (7, 8, 10, 11)
+- macOS (10.14+)
+- Linux (Ubuntu, CentOS, Debian, etc.)
 
-## 🆘 Troubleshooting
+## Troubleshooting
 
 ### Agent won't connect?
 
@@ -141,15 +141,29 @@ Execute the same command across multiple connected devices simultaneously.
 - Report issues on [GitHub](https://github.com/Vaibhav262610/vortix/issues)
 - Contact support: vaibhavrajpoot2626@gmail.com
 
-## 🚀 What's New in v1.2.0
+## What's New in v1.2.2
 
-- 🎨 **Redesigned Dashboard** - Modern Command Center interface
-- 📱 **Mobile Optimization** - Perfect mobile experience
-- ⚡ **Performance Improvements** - Faster real-time updates
-- 🔧 **Enhanced UI** - Better navigation and user experience
-- 🌐 **Cloud-first Architecture** - No backend setup required
+- **Streamlined Dashboard** - Removed screen sharing and auto-start features for
+  cleaner UI
+- **Focus on Core Features** - Simplified interface focused on command execution
+  and monitoring
+- **Updated Components** - Latest agent and backend files included
 
-## 📄 License
+### Previous Updates (v1.2.1)
+
+- **Improved Documentation** - More professional README with better formatting
+- **Enhanced Readability** - Cleaner structure and natural tone
+- **Better User Experience** - Less cluttered documentation
+
+### Previous Updates (v1.2.0)
+
+- **Redesigned Dashboard** - Modern Command Center interface
+- **Mobile Optimization** - Perfect mobile experience
+- **Performance Improvements** - Faster real-time updates
+- **Enhanced UI** - Better navigation and user experience
+- **Cloud-first Architecture** - No backend setup required
+
+## License
 
 MIT License - see
 [LICENSE](https://github.com/Vaibhav262610/vortix/blob/main/LICENSE) for

package/agent/package-lock.json

@@ -9,9 +9,174 @@
       "version": "1.0.0",
       "license": "ISC",
       "dependencies": {
+        "screenshot-desktop": "^1.15.0",
         "ws": "^8.19.0"
       }
     },
+    "node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "license": "MIT"
+    },
+    "node_modules/brace-expansion": {
+      "version": "1.1.12",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
+      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "license": "MIT"
+    },
+    "node_modules/fs.realpath": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+      "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
+      "license": "ISC"
+    },
+    "node_modules/glob": {
+      "version": "7.2.3",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+      "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me",
+      "license": "ISC",
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.1.1",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/inflight": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+      "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
+      "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.",
+      "license": "ISC",
+      "dependencies": {
+        "once": "^1.3.0",
+        "wrappy": "1"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/minimatch": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.3.tgz",
+      "integrity": "sha512-M2GCs7Vk83NxkUyQV1bkABc4yxgz9kILhHImZiBPAZ9ybuvCb0/H7lEl5XvIg3g+9d4eNotkZA5IWwYl0tibaA==",
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/mkdirp": {
+      "version": "0.5.6",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz",
+      "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==",
+      "license": "MIT",
+      "dependencies": {
+        "minimist": "^1.2.6"
+      },
+      "bin": {
+        "mkdirp": "bin/cmd.js"
+      }
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/rimraf": {
+      "version": "2.6.3",
+      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.6.3.tgz",
+      "integrity": "sha512-mwqeW5XsA2qAejG46gYdENaxXjx9onRNCfn7L0duuP4hCuTIi/QO7PDK07KJfp1d+izWPrzEJDcSqBa0OZQriA==",
+      "deprecated": "Rimraf versions prior to v4 are no longer supported",
+      "license": "ISC",
+      "dependencies": {
+        "glob": "^7.1.3"
+      },
+      "bin": {
+        "rimraf": "bin.js"
+      }
+    },
+    "node_modules/screenshot-desktop": {
+      "version": "1.15.3",
+      "resolved": "https://registry.npmjs.org/screenshot-desktop/-/screenshot-desktop-1.15.3.tgz",
+      "integrity": "sha512-bHztitCmaa+A+ssxRa3LDNepQzCHEEAkz1FaJjoZx2yDMkHIkHLKKcc5xMgkGNas97wSGboSB2BoO0c4RnjlJw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/bencevans"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "temp": "^0.9.4"
+      }
+    },
+    "node_modules/temp": {
+      "version": "0.9.4",
+      "resolved": "https://registry.npmjs.org/temp/-/temp-0.9.4.tgz",
+      "integrity": "sha512-yYrrsWnrXMcdsnu/7YMYAofM1ktpL5By7vZhf15CrXijWWrEYZks5AXBudalfSWJLlnen/QUJUB5aoB0kqZUGA==",
+      "license": "MIT",
+      "dependencies": {
+        "mkdirp": "^0.5.1",
+        "rimraf": "~2.6.2"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "license": "ISC"
+    },
     "node_modules/ws": {
       "version": "8.19.0",
       "resolved": "https://registry.npmjs.org/ws/-/ws-8.19.0.tgz",

package/agent/start-local.bat

@@ -0,0 +1,3 @@
+@echo off
+set BACKEND_URL=ws://localhost:8080
+node agent.js start

package/agent/start-production.bat

@@ -0,0 +1,3 @@
+@echo off
+set BACKEND_URL=ws://localhost:8080
+node agent.js start

package/agent/test-screenshot.js

@@ -0,0 +1,19 @@
+// Test script to verify screenshot-desktop works
+const screenshot = require('screenshot-desktop');
+
+console.log('Testing screenshot capture...');
+
+screenshot({ format: 'jpg' })
+    .then((img) => {
+        console.log('✅ Screenshot captured successfully!');
+        console.log(`   Size: ${img.length} bytes`);
+        console.log(`   Base64 length: ${img.toString('base64').length} characters`);
+        console.log('\nScreen sharing should work! 🎉');
+    })
+    .catch((err) => {
+        console.error('❌ Screenshot failed:', err.message);
+        console.error('\nTroubleshooting:');
+        console.error('- Windows: Make sure you have permissions');
+        console.error('- macOS: Grant Screen Recording permission in System Preferences');
+        console.error('- Linux: Install scrot or imagemagick');
+    });

package/backend/DEPLOY.md

@@ -0,0 +1,261 @@
+# Backend Deployment Guide
+
+## ✅ Pre-Deployment Checklist
+
+- [x] Fixed package.json main file (server.js)
+- [x] Fixed PORT configuration
+- [x] Removed unused dependencies (openai, uuid)
+- [x] Cleaned up imports
+- [x] No diagnostic errors
+
+## 🚀 Deploy to Railway (Recommended)
+
+### Step 1: Install Railway CLI
+
+```bash
+npm install -g @railway/cli
+```
+
+### Step 2: Login
+
+```bash
+railway login
+```
+
+### Step 3: Initialize and Deploy
+
+```bash
+cd backend
+railway init
+railway up
+```
+
+### Step 4: Get Your URL
+
+```bash
+railway domain
+```
+
+Example output: `vortix-backend.railway.app`
+
+### Step 5: Test Connection
+
+```bash
+# Install wscat
+npm install -g wscat
+
+# Test connection
+wscat -c wss://vortix-backend.railway.app?token=test
+```
+
+## 🔧 Alternative: Deploy to Render
+
+### Step 1: Go to Render.com
+
+https://render.com
+
+### Step 2: Create Web Service
+
+- Click "New +" → "Web Service"
+- Connect your GitHub repository
+
+### Step 3: Configure
+
+- **Name**: vortix-backend
+- **Root Directory**: `backend`
+- **Environment**: Node
+- **Build Command**: `npm install`
+- **Start Command**: `npm start`
+
+### Step 4: Deploy
+
+Click "Create Web Service"
+
+### Step 5: Get URL
+
+Your service will be at: `https://vortix-backend.onrender.com`
+
+## 🔧 Alternative: Deploy to Heroku
+
+### Step 1: Install Heroku CLI
+
+https://devcenter.heroku.com/articles/heroku-cli
+
+### Step 2: Login
+
+```bash
+heroku login
+```
+
+### Step 3: Create App
+
+```bash
+cd backend
+heroku create vortix-backend
+```
+
+### Step 4: Deploy
+
+```bash
+git push heroku main
+```
+
+### Step 5: Get URL
+
+```bash
+heroku open
+```
+
+## 📝 Post-Deployment
+
+### 1. Save Your Backend URL
+
+```
+Backend URL: wss://your-backend-url.railway.app
+```
+
+### 2. Update Agent
+
+Edit `agent/agent.js` (line ~30):
+
+```javascript
+const ws = new WebSocket(`wss://your-backend-url.railway.app?token=${token}`);
+```
+
+### 3. Update Dashboard
+
+Create `dashboard/.env.local`:
+
+```
+NEXT_PUBLIC_BACKEND_WS=wss://your-backend-url.railway.app
+```
+
+### 4. Test Everything
+
+```bash
+# Test WebSocket connection
+wscat -c wss://your-backend-url.railway.app?token=test
+
+# Should connect without errors
+```
+
+## 🔍 Monitoring
+
+### Railway
+
+```bash
+# View logs
+railway logs --tail
+
+# Check status
+railway status
+
+# View variables
+railway variables
+```
+
+### Render
+
+- Check logs in Render dashboard
+- Monitor at: https://dashboard.render.com
+
+### Heroku
+
+```bash
+# View logs
+heroku logs --tail
+
+# Check status
+heroku ps
+```
+
+## 🐛 Troubleshooting
+
+### Connection Refused
+
+- Check if backend is running
+- Verify PORT is set correctly
+- Check firewall settings
+
+### WebSocket Upgrade Failed
+
+- Ensure using `wss://` (not `ws://`) in production
+- Check if hosting provider supports WebSocket
+
+### AI Planning Not Working
+
+- Ollama must be running locally (not on cloud)
+- Consider switching to OpenAI API for cloud deployment
+- Or remove AI planning feature
+
+### Port Already in Use
+
+```bash
+# Railway/Render handle this automatically
+# For local testing, change PORT in .env
+```
+
+## 🔐 Security Notes
+
+### Current Setup
+
+- Basic token authentication (hostname-based)
+- No rate limiting
+- No command validation
+
+### For Production
+
+1. Implement JWT authentication
+2. Add rate limiting
+3. Validate all commands
+4. Use environment variables for secrets
+5. Enable CORS properly
+6. Add request logging
+
+## 📊 Expected Behavior
+
+### Successful Deployment
+
+```
+✅ Backend running on port 8080
+✅ WebSocket server accepting connections
+✅ Devices can connect
+✅ Dashboard can connect
+✅ Commands route correctly
+```
+
+### Logs Should Show
+
+```
+Backend running on port 8080
+Type: send <DeviceName> <command>
+Registered device: Test-Device
+Token: device-test-device
+Registered device: VAIBHAV-PC
+Token: device-vaibhav-pc
+```
+
+## 🎯 Success Criteria
+
+- [ ] Backend deployed to cloud
+- [ ] WebSocket connections work
+- [ ] URL saved and documented
+- [ ] Agent updated with new URL
+- [ ] Dashboard updated with new URL
+- [ ] End-to-end test successful
+
+## 💰 Costs
+
+- **Railway**: Free tier (500 hrs/month)
+- **Render**: Free tier (750 hrs/month)
+- **Heroku**: Free tier discontinued, starts at $7/month
+
+## 📞 Support
+
+- Railway: https://railway.app/help
+- Render: https://render.com/docs
+- Heroku: https://help.heroku.com
+
+---
+
+**Your backend is ready to deploy!** 🚀

package/backend/Procfile

@@ -0,0 +1 @@
+web: node server.js

package/backend/README.md

@@ -0,0 +1,80 @@
+# Vortix Backend
+
+WebSocket server for coordinating devices and dashboard.
+
+## Features
+
+- WebSocket server for real-time communication
+- Device registration and management
+- Command routing between dashboard and agents
+- AI-powered command planning (Ollama integration)
+- Heartbeat monitoring
+
+## Environment Variables
+
+- `PORT` - Server port (default: 8080)
+
+## Local Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start server
+npm start
+```
+
+Server will run on `ws://localhost:8080`
+
+## Deployment
+
+### Railway
+
+```bash
+railway up
+```
+
+### Render
+
+1. Connect GitHub repo
+2. Set build command: `npm install`
+3. Set start command: `npm start`
+
+### Heroku
+
+```bash
+heroku create
+git push heroku main
+```
+
+## API
+
+### WebSocket Endpoints
+
+**Agent Connection**
+
+```
+ws://backend-url?token=device-hostname
+```
+
+**Dashboard Connection**
+
+```
+ws://backend-url?type=dashboard
+```
+
+## Message Types
+
+See [ARCHITECTURE.md](../docs/ARCHITECTURE.md) for complete message
+documentation.
+
+## Requirements
+
+- Node.js >= 14.0.0
+- Ollama running on localhost:11434 (for AI planning)
+
+## Notes
+
+- AI planning requires Ollama with qwen2.5:7b model
+- Can be modified to use OpenAI instead
+- Supports multiple simultaneous device connections