nodeclicontribution 1.0.0

package/README.md

@@ -0,0 +1,30 @@
+# Groq CLI Extractor
+
+This is a lightweight memory-safe information and context extraction tool powered by Groq's inference engine. It streams local images and PDFs, converts them into natively-encoded Base64 without crashing the V8 heap, and extracts their data using Groq's Vision API.
+
+## 🚀 Installation
+
+Install the package globally via NPM:
+
+```bash
+npm install -g groq-cli-extractor
+
+##⚙️ Configuration
+
+##  Windows(PowerShell)
+$env:GROQ_API_KEY="gsk_your_api_key_here"
+
+## macOS/Linux
+export GROQ_API_KEY="gsk_your_api_key_here"
+
+## 🛠️ Usage
+Once installed and configured, you can extract data from any file (under 5MB) directly from your terminal:
+groq-extract /path/to/your/image.png
+
+## ⚠️ Important Note: Upstream Model Lifecycle
+This CLI currently relies on Groq's Vision models (e.g., meta-llama/llama-4-scout-17b-16e-instruct).
+
+Groq frequently updates, deprecates, and decommissions their preview models. If the tool suddenly begins throwing API errors in the future, it is highly likely the targeted model has been decommissioned by Groq.
+
+If this happens, you will need to update the model string in the source code to Groq's latest supported Vision model and reinstall the package. Check the Groq Model Documentation for the most up-to-date model IDs.
+

package/groq-cli.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import fs from "fs"
+import path from "path"
+import { Groq } from "groq-sdk"
+
+const groq = new Groq({apiKey:process.env.GROQ_API_KEY})
+
+const max_size = 5*1024*1024
+const inputFilePath= process.argv[2]
+
+
+
+if(!inputFilePath){
+    console.error("no path provided")
+    process.exit(1)
+}
+
+const absolutePath = path.resolve(inputFilePath)
+console.log("DEBUG PATH:", absolutePath)
+const stats = fs.statSync(absolutePath)
+const size = stats.size
+
+if(size>max_size){
+    console.error("Error: File exceeds the 5MB API limit.")
+    process.exit(1)
+}
+
+const readStream = fs.createReadStream(absolutePath)
+readStream.setEncoding('base64')
+
+let base64String = ''
+
+readStream.on('data',(chunk)=>{
+    base64String+=chunk
+})
+
+readStream.on('end',async ()=>{
+    console.log("File processed. Contacting Groq API...");
+    try{
+        const response = await groq.chat.completions.create({
+            model:"meta-llama/llama-4-scout-17b-16e-instruct",
+            messages:[
+                {
+                    role:"user",
+                    content:[
+                        {type:"text",text:"Extract and describe the contents of this image/document."},
+                        {type:"image_url",image_url:{url: `data:image/jpeg;base64,${base64String}`}}
+                    ]
+                }
+            ]
+        })
+        console.log("\n--- EXTRACTION COMPLETE ---");
+        console.log(response.choices[0].message.content);
+    }catch(apiError){
+        console.error("API Error",apiError.message)
+    }
+})
+
+readStream.on('error',(err)=>{
+    console.error("error loading data",err.message)
+})
+

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "nodeclicontribution",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "bin": {
+    "groq-extract":"groq-cli.mjs"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "groq-sdk": "^1.2.0"
+  }
+}