Squigit is an open-source "Circle to Search" desktop utility that brings the power of AI vision directly to your screen. It provides seamless screen capture, analysis, and visual search capabilities with a single hotkey.
Explore detailed guides and architecture in our documentation.
- 🎯 Native Performance: Polyglot architecture with C++ capture, Rust orchestration, and Tauri UI.
- 🔗 Bring Your Own Key (BYOK): No middleman. Plug your own Gemini and ImgBB API keys for direct, cost-effective access.
- ⚡ Instant Global Hotkey:
Super/Cmd/Win + Shift + Afreezes your desktop for instant capture from anywhere. - 🧠 Multi-Model Support: Switch between Gemini 3.1 Flash (efficiency) and Gemini 3.1 Pro (power).
- 🪄 Google Lens Integration: One-click visual search by automatically hosting images and launching Google Lens.
- 🔒 Local-First Security: Your API keys, images, and conversations never leave your machine.
- Windows 10+, macOS 12+, or Linux (X11/Wayland)
- 64-bit system
Download the appropriate installer for your operating system:
Download Squigit_Installer.exe.
Download squigit-installer.dmg.
Download squigit-installer.
Grab the latest version of Squigit for your operating system from our Latest Releases page.
- Download the latest Windows setup executable.
- Run the installer.
- SmartScreen Warning: Because Squigit is an open-source project without a commercial EV certificate, Microsoft Defender SmartScreen may initially flag the installer as unrecognized.
- Fix: If you see the "Windows protected your PC" screen, simply click More info, and then select Run anyway.
Note: Squigit's local AI engines are currently optimized strictly for Apple Silicon (M1/M2/M3/M4). Intel Macs are not supported.
- Download the latest
.dmgfile. - Open it and drag Squigit into your
Applicationsfolder. - Gatekeeper / "App is damaged" Warning: Because we use an ad-hoc open-source signature, macOS Gatekeeper may block the app from launching or claim the file is damaged.
- Fix: Open your Terminal and run this command to clear the Apple quarantine flag:
sudo xattr -rd com.apple.quarantine /Applications/Squigit.app
- (Alternatively: Go to System Settings -> Privacy & Security, scroll to the bottom, and click "Open Anyway").
- Fix: Open your Terminal and run this command to clear the Apple quarantine flag:
Note: Squigit is distributed as an AppImage to ensure maximum compatibility across different Linux distributions.
- Download the latest
.AppImagefile. - Make it Executable: By default, Linux prevents new downloads from running as programs. You must grant the file execution permissions before launching it.
- Fix: Open your terminal in the directory where you downloaded the file and run:
chmod +x Squigit-*.AppImage - You can now double-click the file to run it, or integrate it into your desktop environment using tools like AppImageLauncher.
- Fix: Open your terminal in the directory where you downloaded the file and run:
- Press
Super/Cmd/Win + Shift + Aanywhere to freeze your screen - Draw any shape around content with intelligent cropping
- Get immediate AI analysis powered by Google Gemini models
- Continue conversations with follow-up questions
- Direct Gemini API Access: Your prompts go straight to Google's models with zero hops
- Visual Context Injection: Screenshots are automatically included in chat context
- Model Hot-Swapping: Instantly switch between Gemini models for different tasks
- One-Click Google Lens: Upload screenshots to ImgBB and open in Google Lens
- Secure Image Handling: Local encryption with AES-256 for API keys
- Privacy-First: No central server, no data collection
- Global Hotkey Registration: Works across all applications
- Multi-Monitor Support: Captures and manages all displays simultaneously
- Platform-Optimized Capture: Different strategies for X11, Wayland, Windows, and macOS
🔐 Authentication: Bring Your Own Key (BYOK)
Squigit operates on a zero-trust, local-first model where you provide your own API keys.
- Launch Squigit and signup
- Generate API Keys on the official provider sites:
- Gemini: Google AI Studio
- ImgBB: ImgBB API
- Copy to Clipboard - Squigit automatically detects and securely stores your keys
- Local Storage: Keys encrypted with AES-256 and stored in your user directory
- Direct Communication: No proxy servers - requests go directly to
generativelanguage.googleapis.comandapi.imgbb.com - Clipboard Safety: Keys are never manually pasted; automatic detection prevents keylogging exposure
- Revocable Access: You control and can revoke keys anytime via provider dashboards
- Press
Super/Cmd/Win + Shift + A - Draw a shape around the content you want to analyze
- Release to capture and open Squigit with AI analysis
- Open Squigit from your applications menu
- Drag & drop an image or use the file dialog
- Chat with the AI about your uploaded image
- Capture or upload an image
- Click the "Google Lens" button in the chat interface
- Visual search opens in your default browser
# 1. Press Super+Shift+A
# 2. Draw around the code snippet
# 3. Ask: "Explain this function and suggest improvements"# 1. Press Super+Shift+A on an article
# 2. Draw around the text
# 3. Ask: "Summarize the key points and find related sources"# 1. Press Super+Shift+A on a product image
# 2. Draw around the product
# 3. Click "Google Lens" to find it online- Quick Start Guide - First-time setup and basic usage
- Installation Guide - Detailed installation instructions
- BYOK Model - Understanding Bring Your Own Key
- System Architecture - High-level overview with diagrams
- Build System - Compilation and packaging
- CaptureKit - Screen capture engine (C++/Qt6)
- Orchestrator - Core lifecycle manager (Rust)
- Squigit App - Electron/React application
- Development Guide - Setting up your dev environment
- Contributing Guide - How to contribute
- Debugging Guide - Troubleshooting and diagnostics
- CI/CD Architecture - Automated build pipelines
- Installer Architecture - Cross-platform deployment
- Release Strategy - Version control and updates
- Configuration Guide - Runtime configuration files
- IPC Protocol - Inter-process communication
- Code of Conduct - Community guidelines
- Security Policy - Vulnerability reporting and practices
We welcome contributions! Squigit is fully open source, and we encourage the community to:
- Report bugs and suggest features
- Improve documentation
- Submit code improvements
- Share platform-specific optimizations
See our Contributing Guide for development setup, coding standards, and how to submit pull requests.
Check our TODO List for planned features and priorities.
- Documentation - Complete documentation hub
- GitHub Issues - Report bugs or request features
- Security Policy - Security updates and reporting
- License: Apache License 2.0
- Security: Security Policy
- Privacy Policy: Privacy Policy
- Terms of Service: Terms
- Privacy: No data collection, local-only operation
Built with ❤️ by the open source community