carvus-lens 1.0.0

package/README.md

@@ -0,0 +1,26 @@
+# CARVUS-SEARCH
+
+CARVUS-SEARCH is a highly advanced, ultra-fast background desktop utility for Linux (and Windows/macOS) that brings the ultimate "Circle to Search" experience directly to your computer!
+
+## Features
+
+1. **Background Service Engine**: Runs silently in the background with zero performance impact.
+2. **Instant Trigger**: Press **`Super + C`** (Windows/Command Key + C) from ANY application to instantly freeze your screen and pull up the overlay. If not working press it again and again
+3. **Official Google Search (Legal)**: Draw a circle anywhere on your screen. The app extracts text using **Tesseract.js** and instantly triggers an official **Google Programmable Search Engine** lookup. This is the 100% legal way to integrate Google Search results directly into your workflow!
+4. **Cloud-Speed AI**: Click **Ask AI** or **Translate** to send the extracted text to the blazing-fast Groq AI engine (Llama 3.3 70B) for instant summaries, answers, and translations.
+5. **Read Aloud & Clipboard**: One-click to copy text or have the system dictate it out loud using native text-to-speech!
+6. **Next-Next-Gen Aesthetics**: Gorgeous edge lighting, moving particle effects, and a glassmorphic draggable popup window.
+
+## How to Use
+
+1. Start the engine:
+   ```bash
+   npm start
+   ```
+2. The app runs in the background. Press **`Super + C`** (Windows Key + C) to freeze the screen and start circling!
+3. Draw a circle around any text, image, or question.
+4. The Google Search results will appear automatically in the popup.
+5. Use the Action Bar to switch to **Ask AI**, **Translate**, or **Copy** the text.
+
+## Legal Note
+This app uses the **Google Programmable Search Element API**, which is the official and compliant way to embed Google Search. No scraping or ToS violations!

package/bin/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+const { execSync } = require('child_process');
+const path = require('path');
+
+const electronPath = path.join(__dirname, '..', 'node_modules', '.bin', 'electron');
+const appPath = path.join(__dirname, '..');
+
+try {
+  execSync(`"${electronPath}" "${appPath}"`, { stdio: 'inherit' });
+} catch (e) {
+  // App closed normally
+}