@charliejhills: Someone just open-sourced a Cluely alternative. OpenCluely is a free Electron app that gives you real time AI assistanc…
Summary
OpenCluely is a free, open-source Electron app that provides real-time AI assistance during technical interviews using Gemini Vision, with stealth features to avoid detection. It is an alternative to the paid Cluely service.
View Cached Full Text
Cached at: 05/22/26, 01:53 PM
Someone just open-sourced a Cluely alternative.
OpenCluely is a free Electron app that gives you real time AI assistance during technical interviews. No telemetry. No company watching your sessions. Full source code on GitHub.
Here’s what it does:
⇢ Invisible overlay that lets clicks pass through Your screen sharing stays clean. The interviewer sees nothing.
⇢ Gemini Vision instead of OCR It reads your screen visually rather than parsing text. Fewer failure points, more context.
⇢ Persistent session context It remembers what happened earlier in the interview. Your answers stay consistent across the whole session.
⇢ Multi-language support Works across stacks. Not locked to one language.
⇢ Zero telemetry No usage data. No third-party calls. Nothing leaves your machine.
Cluely raised millions selling “undetectable AI assistance” as a premium product.
OpenCluely does the same thing for free.
And you can read every line before you run it.
That distinction matters more than people are admitting.
GitHub: http://github.com/TechyCSR/OpenCluely…
TechyCSR/OpenCluely
Source: https://github.com/TechyCSR/OpenCluely
🧠 OpenCluely
Core is working; improvements are shipping daily.
OpenCluely is a revolutionary AI-powered desktop application that provides invisible, real-time assistance during technical rounds.
🎬 Demo Video
https://github.com/user-attachments/assets/896a7140-1e85-405d-bfbe-e05c9f3a816b
🌟 Why OpenCluely?
🥷 100% Stealth Mode
|
🚀 AI-Powered Intelligence
|
🖼️ Modern UI Features
📱 Interactive Windows
- Floating Overlay Bar: Compact command center with camera, mic, and skill selector
- Draggable Answer Window: Move and resize AI response window anywhere
- Close Button: Clean × button to close answer window when needed
- Auto-Hide Mic: Microphone button appears only when a speech provider is available
- Interactive Chat: Full conversation window with markdown support
🎨 Visual Design
- Glass Morphism: Beautiful blur effects and transparency
- Adaptive Layout: UI adjusts based on available services
- Smart Resizing: Windows resize automatically to fit content
- Professional Look: Mimics system applications for perfect stealth
🎯 Functional Overview
📋 Core Components
🖱️ Main Overlay
|
💬 Interactive Chat
|
📊 Answer Window
|
⚙️ Configuration
The setup script automatically handles configuration. You only need:
# Required: Google Gemini API Key (setup script will ask for this)
GEMINI_API_KEY=your_gemini_api_key_here
# Optional: Speech Recognition (pick one provider)
SPEECH_PROVIDER=whisper
# Azure option
AZURE_SPEECH_KEY=your_azure_speech_key
AZURE_SPEECH_REGION=your_region
# Local Whisper option
WHISPER_COMMAND=whisper
WHISPER_MODEL_DIR=.whisper-models
WHISPER_MODEL=base
WHISPER_LANGUAGE=en
WHISPER_SEGMENT_MS=4000
Note: Speech recognition is completely optional. If no configured provider is available, the microphone button will be automatically hidden from all interfaces.
🚀 Quick Start & Installation
⚡ Three Simple Steps (All Operating Systems)
-
Clone the repository
git clone https://github.com/TechyCSR/OpenCluely.git cd OpenCluely -
Get your Gemini API key (Required)
- Visit Google AI Studio
- Click “Create API Key”
- Copy the key (you’ll need it in step 3)
-
Run the setup script (One command does everything!)
./setup.sh
That’s it! The setup script will:
- Install all dependencies automatically
- Create your
.envfile fromenv.exampleif needed - Set up a local Whisper virtualenv in
.venv-whisper - Configure
.envto use local Whisper by default - Build the app (if needed)
- Launch OpenCluely ready to use (if not works use npm install & then npm start)
💻 Platform-Specific Notes
- Windows: Use Git Bash (comes with Git for Windows), WSL, or any bash environment
- macOS/Linux: Use your regular terminal
- All platforms: No manual npm commands needed - the setup script handles everything
- Windows Whisper path:
setup.shnow writesWHISPER_COMMAND=.venv-whisper/Scripts/whisper.exe - macOS/Linux Whisper path:
setup.shwritesWHISPER_COMMAND=.venv-whisper/bin/whisper
🎛️ Setup Script Options
./setup.sh --build # Build distributable for your OS
./setup.sh --ci # Use npm ci instead of npm install
./setup.sh --no-run # Setup only, don't launch the app
./setup.sh --install-system-deps # Install sox for microphone (optional)
./setup.sh --skip-whisper # Skip the local Whisper bootstrap
🔧 Optional: Speech Setup (For Voice Features)
Voice recognition is optional. You can use either Azure Speech or local OpenAI Whisper.
For the local Whisper path, ./setup.sh now handles the full repo-local setup:
-
Creates
.venv-whisper -
Installs
openai-whisper -
Points
.envat.venv-whisper/bin/whisper -
Creates
.whisper-models -
Runs
npm run test-speech -
For Azure Speech:
- Visit Azure Portal
- Create a Speech Service
- Copy your key and region
-
For local Whisper:
- Run
./setup.sh --install-system-deps - Or install required audio tools such as
ffmpegandsoxyourself - On Windows, install audio tooling separately and prefer Git Bash or WSL for
setup.sh
- Run
-
Add one provider to your
.envfile:GEMINI_API_KEY=your_gemini_api_key_here SPEECH_PROVIDER=azure AZURE_SPEECH_KEY=your_azure_speech_key AZURE_SPEECH_REGION=your_regionGEMINI_API_KEY=your_gemini_api_key_here SPEECH_PROVIDER=whisper WHISPER_COMMAND=whisper WHISPER_MODEL_DIR=.whisper-models WHISPER_MODEL=base WHISPER_LANGUAGE=en WHISPER_SEGMENT_MS=4000 -
Restart the app - microphone buttons will now appear automatically
🎮 How to Use
🖱️ Main Controls
| Action | Shortcut | Description |
|---|---|---|
| Screenshot Capture | ⌘⇧S | Capture screen and analyze via Gemini (image understanding) |
| Toggle Speech | Alt+R | Start/stop voice recognition (if configured) |
| Toggle Visibility | ⌘⇧V | Show/hide all windows |
| Toggle Interaction | ⌘⇧I or Alt+A | Enable/disable window interaction |
| Switch to Chat | ⌘⇧C | Open interactive chat window |
| Settings | ⌘, | Open settings panel |
🎯 Workflow
- Start OpenCluely → App appears as system process (Terminal/Activity Monitor)
- Position Windows → Drag overlay and answer windows to preferred locations
- Capture Questions → Use screenshot (⌘⇧S) or voice commands
- Get AI Answers → Instant responses in draggable answer window
- Interactive Chat → Type or speak for detailed conversations
- Stay Stealth → All operations invisible to screen recording
🔧 Advanced Features
🎨 Window Management
- Draggable Interface: Click and drag any window to reposition
- Auto-resize: Windows automatically adjust to content
- Close Button: Click × to close answer window
- Always on Top: Windows stay above all applications
🧠 AI Intelligence
- Context Awareness: Remembers entire conversation
- Code Detection: Automatically formats code blocks
- Language Specific: Tailored responses for selected programming language
- Session Memory: Maintains context across multiple questions
- Image Understanding: DSA prompt is applied only for new image-based queries; chat messages don’t include the full prompt
- Multi-monitor & Area Capture: Programmatic APIs allow targeting a display and optional rectangular crop for focused analysis
🔊 Optional Voice Features (Azure Speech / Local Whisper)
- Chunked Local Transcription: Local Whisper transcribes short recorded segments on your machine
- Real-time Transcription: Azure Speech supports live interim recognition
- Listening Animation: Visual feedback during recording
- Interim Results: Available with Azure Speech
- Auto-processing: Instant AI responses to voice input ]
🧩 Troubleshooting
Setup Issues
-
setup.sh not found or won’t run
- Make sure you’re in the OpenCluely directory:
cd OpenCluely - Make the script executable:
chmod +x setup.sh - On Windows, use Git Bash (comes with Git for Windows)
- Make sure you’re in the OpenCluely directory:
-
Setup script stops with exit code 130
- This means you pressed Ctrl+C. Just run
./setup.shagain
- This means you pressed Ctrl+C. Just run
-
Node or npm not found
- Install Node.js 18+ from nodejs.org
- Restart your terminal and try again
App Issues
-
Electron won’t start or shows blank window (Linux)
- Try:
npm run dev - Ensure X11/XWayland is available if running in headless environments
- Try:
-
macOS screen capture doesn’t work
- Grant “Screen Recording” permission in System Settings → Privacy & Security → Screen Recording
- Quit and relaunch the app after granting permission
-
Windows SmartScreen blocks the app
- Click “More info” → “Run anyway” or use
npm startduring development
- Click “More info” → “Run anyway” or use
-
Microphone/voice not working
- Voice is optional - ignore related warnings if you don’t need it
- Azure mode: add valid Azure keys to
.env - Whisper mode: install
openai-whisper,ffmpeg, andsox, then setSPEECH_PROVIDER=whisper
⚖️ Legal & Ethics
📋 Disclaimer
OpenCluely is provided for educational and research purposes. Users are responsible for:
- Complying with interview guidelines
- Respecting company policies
- Understanding legal implications
- Using ethically and responsibly
🔒 Privacy
- No data collection or telemetry
- All processing happens locally
- API communications are encrypted
- Session data stays on your device
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
-
Google Gemini: Powering AI intelligence
-
Azure Speech / Whisper: Optional voice recognition
-
Electron: Cross-platform desktop framework
-
Community: Amazing contributors and feedback
-
Vysper: UI and code structure inspiration — see Vysper by varun-singhh
⭐ Star this repo if OpenCluely helped you ace your interviews or you vibed with it!
Made with ❤️ by TechyCSR
Similar Articles
openclaw/openclaw
OpenClaw is a personal AI assistant that runs locally on user devices and integrates with various messaging channels through a central gateway, supporting connection to AI models and tools.
@nityeshaga: Claude Code is the OpenClaw alternative you already had. I've been telling people this in person for three months. Now …
An article argues that Claude Code is the alternative to OpenClaw that users already have, highlighting that both are harnesses on top of AI models and Claude Code is often overlooked as a tool for non-programmers.
Google is launching its own version of OpenClaw
Google launches Gemini Spark, an always-on AI agent powered by Gemini 3.5 Flash, with background operation, integrations across Workspace and third-party apps via MCP, and updates to Antigravity.
@garrytan: If you really think about it Cluely as a realtime thought helper and semi-adversarial assistant with ongoing context is…
The tweet discusses the concept of Cluely as a realtime AI thought helper and mentions a trend of VCs using AI tools like Granola and Claude to evaluate pitches, highlighting concerns about AI groupthink.
@github: OpenClaw. Is it the Linux of AI?
The tweet questions if OpenClaw, a project on GitHub, could become the Linux equivalent for the AI field, suggesting its potential significance as an open-source initiative.