cloud-pc-templates 1.2.2 → 1.3.0

package/README.md

@@ -114,6 +114,36 @@ $ npx cloud-pc-templates ai login loginMode ollamalocal
 - 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. Prompts you to enter your Hugging Face API Key (masked input with asterisks)
+2. Downloads the Hugging Face proxy script from GitHub
+3. Runs the proxy on port 3006 with your API key
+4. Validates the proxy health endpoint
+5. Displays "Logged in" confirmation
+
+**Example:**
+```bash
+$ npx cloud-pc-templates ai login loginMode huggingface
+Enter Hugging Face API Key: ****************************
+✓ Logged in
+  - Endpoint checked: http://localhost:3006/health
+```
+
+**Features:**
+- Masked input for API key (shows `*` instead of actual characters)
+- Supports pasting long API keys
+- Backspace support for corrections
+- Runs proxy on port 3006
+- Real-time proxy output logging for debugging
+- Get your API key from: https://huggingface.co/settings/tokens
+
 ### Command Discovery
 
 The CLI features intelligent command discovery. If you don't provide all required arguments, it shows available options:
@@ -146,6 +176,7 @@ 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
@@ -170,6 +201,12 @@ cloud-pc-templates/
 - `checkProxyHealth()`: Health check for the offline proxy
 - `checkAndLoginOllamaLocal()`: Main login orchestrator with warning system
 
+#### handlers/huggingface.js
+- `promptForApiKey()`: Interactive masked API key input
+- `checkHealthEndpoint()`: Health check for proxy server
+- `downloadAndRunProxy()`: Downloads and executes proxy script with API key
+- `checkAndLoginHuggingFace()`: Main login orchestrator
+
 #### handlers/launch.js
 - `openBrowser()`: Cross-platform browser launcher
 - `launchWebsite()`: Opens cloud-pc-templates.com
@@ -288,10 +325,17 @@ When entering your API key:
 - Start Ollama with: `ollama serve`
 - Check if Ollama is running on port 11434:
   ```bash
-  curl http://localhost:11434/api/health
+  curl http://localhost:11434/api/tags
   ```
 - Ensure port 3005 is not in use by another application
 
+### Hugging Face login fails
+- Check that you have a valid Hugging Face API key
+- Get your API key from: https://huggingface.co/settings/tokens
+- Make sure your API key has the necessary permissions
+- Ensure port 3006 is not in use by another application
+- Check your internet connection for accessing Hugging Face services
+
 ### 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`

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/handlers/ollamalocal.js

@@ -15,7 +15,7 @@ function checkOllamaHealth() {
       {
         hostname: 'localhost',
         port: OLLAMA_PORT,
-        path: '/api/health',
+        path: '/api/tags',
         method: 'GET'
       },
       (res) => {

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.2",
+  "version": "1.3.0",
   "description": "",
   "main": "index.js",
   "bin": {