cloud-pc-templates 1.2.3 → 1.3.1

package/README.md

@@ -7,6 +7,14 @@ Cloud PC Templates is a command-line tool for managing cloud PC configurations a
 ```bash
 npm install -g cloud-pc-templates
 ```
+## Video Tutorial
+
+For a step-by-step guide on using Cloud PC Templates, watch this video tutorial:
+
+[![Cloud PC Templates Tutorial](https://img.youtube.com/vi/XMF0K9R2rD0/0.jpg)](https://www.youtube.com/watch?v=XMF0K9R2rD0)
+
+[Click here to watch on YouTube](https://www.youtube.com/watch?v=XMF0K9R2rD0)
+
 
 ## Usage
 
@@ -42,14 +50,7 @@ npx cloud-pc-templates ai login loginMode ollamacloud
 ```
 
 **What it does:**
-1. Checks if you're already logged in by testing the health endpoint at `http://localhost:3004/health`
-2. If already logged in, displays "Already logged in" message
-3. If not logged in:
-   - Prompts you to enter your API Key (masked input with asterisks)
-   - Downloads the Ollama proxy script from GitHub
-   - Runs the proxy with your API key as an argument
-   - Validates the health endpoint
-   - Displays "Logged in" confirmation
+1. Runs a wrapper service at `http://localhost:3004/health` which is an interface to ollama cloud models, it requires ollama api key.
 
 **Example:**
 ```bash
@@ -59,27 +60,15 @@ Enter API Key: **************************
   - Endpoint checked: http://localhost:3004/health
 ```
 
-**Features:**
-- Masked input for API key (shows `*` instead of actual characters)
-- Supports pasting long API keys
-- Backspace support for corrections
-- Cross-platform terminal support (TTY and non-TTY)
-- Real-time proxy output logging for debugging
-
 ##### Ollama Local Login
 
-Connect to Ollama Local instance:
+Connect to Ollama Local models:
 ```bash
 npx cloud-pc-templates ai login loginMode ollamalocal
 ```
 
 **What it does:**
-1. Checks if Ollama is running on the default port (11434)
-2. If Ollama is not running, displays a warning with installation instructions
-3. Downloads the Ollama Offline Proxy script from GitHub
-4. Runs the proxy on port 3005 (no API key required)
-5. Validates the proxy health endpoint
-6. Displays "Logged in" confirmation
+1. Runs a wrapper service to connect to ollama local models
 
 **Example (with Ollama running):**
 ```bash
@@ -93,26 +82,29 @@ $ npx cloud-pc-templates ai login loginMode ollamalocal
   - Ollama running on: localhost:11434
 ```
 
-**Example (without Ollama running):**
-```bash
-$ npx cloud-pc-templates ai login loginMode ollamalocal
-🔍 Checking if Ollama is running...
-⚠️  WARNING: Ollama is not running on localhost:11434
-   Please install Ollama and run it before using this login mode.
-   Download Ollama from: https://ollama.ai
-
-   After installation, start Ollama with:
-   ollama serve
-
-   Continuing anyway...
-```
-
 **Features:**
 - No API key required
 - Checks for local Ollama installation
 - Helpful warnings with installation instructions
 - Runs proxy on port 3005
-- Provides detailed status output
+
+##### Hugging Face Login
+
+Connect to Hugging Face services:
+```bash
+npx cloud-pc-templates ai login loginMode huggingface
+```
+
+**What it does:**
+1. Runs a wrapper service over huggingface cloud models and it requires huggingface api key
+
+**Example:**
+```bash
+$ npx cloud-pc-templates ai login loginMode huggingface
+Enter Hugging Face API Key: ****************************
+✓ Logged in
+  - Endpoint checked: http://localhost:3006/health
+```
 
 ### Command Discovery
 
@@ -146,43 +138,12 @@ cloud-pc-templates/
 ├── handlers/
 │   ├── ollamacloud.js      # Ollama Cloud login functionality
 │   ├── ollamalocal.js      # Ollama Local login functionality
+│   ├── huggingface.js      # Hugging Face login functionality
 │   └── launch.js           # Website launcher
 ├── package.json            # Project metadata and bin configuration
 └── README.md               # This file
 ```
-
-### Modules
-
-#### index.js
-- **Command Tree**: Hierarchical command structure supporting nested subcommands
-- **Argument Parsing**: Handles command-line arguments with `--` prefix stripping
-- **Request Routing**: Routes commands to appropriate handlers
-
-#### handlers/ollamacloud.js
-- `promptForApiKey()`: Interactive masked API key input
-- `checkHealthEndpoint()`: Health check for proxy server
-- `downloadAndRunProxy()`: Downloads and executes proxy script with API key
-- `checkAndLoginOllamaCloud()`: Main login orchestrator
-
-#### handlers/ollamalocal.js
-- `checkOllamaHealth()`: Verifies Ollama is running on port 11434
-- `downloadAndRunProxy()`: Downloads and executes offline proxy script
-- `checkProxyHealth()`: Health check for the offline proxy
-- `checkAndLoginOllamaLocal()`: Main login orchestrator with warning system
-
-#### handlers/launch.js
-- `openBrowser()`: Cross-platform browser launcher
-- `launchWebsite()`: Opens cloud-pc-templates.com
-
-## Features
-
-### Masked API Key Input
-When logging in to Ollama Cloud, your API key is protected:
-- Each character you type displays as an asterisk `*`
-- Works with keyboard input and pasted text
-- Supports backspace for corrections
-
-### Cross-Platform Support
+### Cross-Platform Support for the launch command
 The launch command works on:
 - macOS (uses `open` command)
 - Linux (uses `xdg-open` command)
@@ -216,36 +177,6 @@ Each handler is a separate module that can be:
 - Extended with new features
 - Reused in other projects
 
-### Adding New Commands
-
-To add a new command:
-
-1. Create a new handler file in `handlers/`:
-```javascript
-// handlers/mycommand.js
-async function myCommandHandler() {
-  // Implementation
-}
-
-module.exports = { myCommandHandler };
-```
-
-2. Import it in `index.js`:
-```javascript
-const { myCommandHandler } = require('./handlers/mycommand');
-```
-
-3. Add it to the command tree:
-```javascript
-const commandTree = {
-  // ... existing commands
-  mycommand: {
-    description: 'My command description',
-    handler: () => myCommandHandler()
-  }
-};
-```
-
 ## NPM Script
 
 The project is configured with a binary entrypoint in `package.json`:
@@ -260,59 +191,10 @@ The project is configured with a binary entrypoint in `package.json`:
 
 This enables the `npx cloud-pc-templates` command globally.
 
-## API Key Security
-
-When entering your API key:
-- Input is masked with asterisks
-- Key is passed directly to the proxy process
-- Never logged or stored in plain text
-- Passed via command-line argument or environment variable
-
-## Troubleshooting
-
-### "Unknown command" error
-- Make sure you've spelled the command correctly
-- Use `npx cloud-pc-templates help` to see available commands
-- Commands are case-sensitive
-
-### Ollama Cloud login fails
-- Check that you have a valid API key
-- Ensure your network connection is stable
-- Try checking if the health endpoint is accessible manually:
-  ```bash
-  curl http://localhost:3004/health
-  ```
-
-### Ollama Local login fails
-- Make sure Ollama is installed: https://ollama.ai
-- Start Ollama with: `ollama serve`
-- Check if Ollama is running on port 11434:
-  ```bash
-  curl http://localhost:11434/api/tags
-  ```
-- Ensure port 3005 is not in use by another application
-
-### Browser won't open with `launch`
-- Ensure you have a default browser configured
-- On Linux, make sure `xdg-open` is installed: `sudo apt-get install xdg-utils`
-- On Windows, ensure a browser is set as default
-- On Android/Termux:
-  - For best results, install Termux API: `pkg install termux-api`
-  - Otherwise, `xdg-open` will be used as fallback
-  - Ensure you have a browser app installed on your device
-
-## Video Tutorial
-
-For a step-by-step guide on using Cloud PC Templates, watch this video tutorial:
-
-[![Cloud PC Templates Tutorial](https://img.youtube.com/vi/XMF0K9R2rD0/0.jpg)](https://www.youtube.com/watch?v=XMF0K9R2rD0)
-
-[Click here to watch on YouTube](https://www.youtube.com/watch?v=XMF0K9R2rD0)
-
 ## License
 
 ISC
 
 ## Author
 
-Cloud PC Templates Contributors
+Devashish Priyadarshi

package/handlers/huggingface.js

@@ -0,0 +1,169 @@
+const http = require('http');
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+const PROXY_PORT = 3003;
+
+// Function to get masked API key input
+function promptForApiKey() {
+  return new Promise((resolve) => {
+    process.stdout.write('Enter Hugging Face API Key: ');
+    
+    const stdin = process.stdin;
+    
+    // Handle both TTY and non-TTY environments
+    if (stdin.isTTY) {
+      stdin.setRawMode(true);
+    }
+    stdin.resume();
+    
+    let apiKey = '';
+    
+    stdin.on('data', (buffer) => {
+      const chunk = buffer.toString();
+      
+      // Process each character in the chunk (handles pasted text)
+      for (let i = 0; i < chunk.length; i++) {
+        const char = chunk[i];
+        
+        if (char === '\n' || char === '\r' || char === '\u0004') {
+          // Enter or EOF
+          if (stdin.isTTY) {
+            stdin.setRawMode(false);
+          }
+          stdin.pause();
+          stdin.removeAllListeners('data');
+          console.log('');
+          resolve(apiKey);
+          return;
+        } else if (char === '\u0003') {
+          // Ctrl+C
+          if (stdin.isTTY) {
+            stdin.setRawMode(false);
+          }
+          process.exit();
+        } else if (char === '\x7f' || char === '\b') {
+          // Backspace
+          if (apiKey.length > 0) {
+            apiKey = apiKey.slice(0, -1);
+            process.stdout.write('\x1b[D\x1b[K');
+          }
+        } else if (char >= '\x20' && char <= '\x7e') {
+          // Printable character
+          apiKey += char;
+          process.stdout.write('*');
+        }
+      }
+    });
+  });
+}
+
+// Function to check health endpoint
+function checkHealthEndpoint(endpoint) {
+  return new Promise((resolve) => {
+    const url = new URL(endpoint);
+    const protocol = url.protocol === 'https:' ? https : http;
+    
+    const request = protocol.request(url, { method: 'GET' }, (res) => {
+      resolve(res.statusCode === 200);
+    });
+    
+    request.on('error', () => {
+      resolve(false);
+    });
+    
+    request.end();
+  });
+}
+
+// Function to download and run the proxy
+async function downloadAndRunProxy(endpoint) {
+  const url = 'https://raw.githubusercontent.com/devashish234073/cloud-pc-templates-marketplace/refs/heads/main/JS-PROXIES/hf-proxy.js';
+  const tempFile = path.join(os.tmpdir(), 'hf-proxy.js');
+  
+  // Download the file
+  await new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(tempFile);
+    https.get(url, (res) => {
+      res.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    }).on('error', reject);
+  });
+  
+  // Get API key from user
+  const apiKey = await promptForApiKey();
+  
+  // Run the proxy with API key passed as command-line argument
+  return new Promise((resolve, reject) => {
+    const child = spawn('node', [tempFile, apiKey]);
+    
+    let serverReady = false;
+    
+    // Capture stdout to detect when server is ready
+    child.stdout.on('data', (data) => {
+      const output = data.toString();
+      console.log(output);
+      
+      // Check if server indicates it's ready
+      if (output.includes('listening') || output.includes('started') || output.includes('running')) {
+        serverReady = true;
+      }
+    });
+    
+    // Capture stderr for error messages
+    child.stderr.on('data', (data) => {
+      console.error(data.toString());
+    });
+    
+    // Wait a bit for server to start, then validate
+    setTimeout(async () => {
+      try {
+        const isHealthy = await checkHealthEndpoint(endpoint);
+        if (isHealthy) {
+          console.log('✓ Logged in');
+          console.log(`  - Endpoint checked: ${endpoint}`);
+        } else {
+          console.log('✓ Proxy started');
+          console.log(`  - Endpoint: ${endpoint}`);
+        }
+        resolve();
+      } catch (error) {
+        reject(error);
+      }
+    }, 2000);
+    
+    child.on('error', reject);
+  });
+}
+
+// Function to check and login to Hugging Face
+async function checkAndLoginHuggingFace() {
+  const endpoint = `http://localhost:${PROXY_PORT}/health`;
+  
+  try {
+    const isHealthy = await checkHealthEndpoint(endpoint);
+    if (isHealthy) {
+      console.log('✓ Already logged in');
+      console.log(`  - Endpoint checked: ${endpoint}`);
+      return;
+    }
+    
+    // Not healthy, download and run proxy
+    await downloadAndRunProxy(endpoint);
+  } catch (error) {
+    console.error('Error during login:', error.message);
+  }
+}
+
+module.exports = {
+  checkAndLoginHuggingFace,
+  checkHealthEndpoint,
+  downloadAndRunProxy,
+  promptForApiKey
+};

package/index.js

@@ -2,6 +2,7 @@
 
 const { checkAndLoginOllamaCloud } = require('./handlers/ollamacloud');
 const { checkAndLoginOllamaLocal } = require('./handlers/ollamalocal');
+const { checkAndLoginHuggingFace } = require('./handlers/huggingface');
 const { launchWebsite } = require('./handlers/launch');
 
 // Command tree structure
@@ -27,6 +28,10 @@ const commandTree = {
               ollamalocal: {
                 description: 'Connect to Ollama Local',
                 handler: () => aiLogin('ollamalocal')
+              },
+              huggingface: {
+                description: 'Connect to Hugging Face',
+                handler: () => aiLogin('huggingface')
               }
             }
           }
@@ -54,6 +59,7 @@ function help() {
   console.log('AI Commands:');
   console.log('  npx cloud-pc-templates ai login loginMode ollamacloud');
   console.log('  npx cloud-pc-templates ai login loginMode ollamalocal');
+  console.log('  npx cloud-pc-templates ai login loginMode huggingface');
 }
 
 // Default AI function
@@ -67,6 +73,8 @@ async function aiLogin(mode) {
     await checkAndLoginOllamaCloud();
   } else if (mode === 'ollamalocal') {
     await checkAndLoginOllamaLocal();
+  } else if (mode === 'huggingface') {
+    await checkAndLoginHuggingFace();
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloud-pc-templates",
-  "version": "1.2.3",
+  "version": "1.3.1",
   "description": "",
   "main": "index.js",
   "bin": {