Skip to content

README_EN.md

Latest commit

 

History

History
249 lines (170 loc) · 7.42 KB

README_EN.md

File metadata and controls

249 lines (170 loc) · 7.42 KB
Q-Solver Banner

🧠 Q-Solver

AI-Powered Real-Time Desktop Assistant · Screen Analysis · Voice Chat

🎯 Snapshot → Think → Solve. Your invisible AI Co-pilot.

Stars Release Go Vue Wails

macOS Windows


Features • Install • Demo • Shortcuts • 中文文档


Demo


Caution

🚧 Development Status: This project is currently in Pre-Alpha. Features may change significantly. Proceed with caution.


🌟 Core Highlights

🖼️ Instant Screen Solving

Capture any part of your screen and get an instant AI analysis with a single hotkey.

  • 📸 Smart Recognition: Accurately recognizes text, math formulas, and code.
  • 🧠 Deep Thinking: Powered by extensive reasoning models like o1 and Claude 3.5.
  • ⚡️ Zero Distraction: Floating ghost window designed not to interrupt your flow.

🎙️ Immersive Voice Chat

Integrated with Google Gemini Live API for a seamless real-time conversation experience.

  • 🗣️ Natural Interaction: Millisecond latency, feels just like a human call.
  • 🗺️ Auto Mind Map: Visualizes your conversation structure automatically.
  • 📝 Smart Notes: Auto-transcribes and summarizes key points.

✨ Core Features

🛡️ Stealth Mode

Designed for privacy and multitasking, offering a "Ghost Window" experience.

⚠️ Note: Please test the actual effect yourself.

Feature Description
🚫 Recording Proof Invisible to most screen recording/sharing software.
👻 Click-Through Enable to interact with content behind the window seamlessly.
📌 Always on Top Floats above all other windows for quick reference.
🔕 Focus Guard Intelligently manages window focus to avoid stealing keystrokes.

🧠 Model Ecosystem

Supports OpenAI / Gemini / Claude / DeepSeek (Custom) and more.

  • Live API: Experience millisecond-latency voice chat with Gemini 2.0.
  • Custom Models: Compatible with any OpenAI format API.

📸 Interface Showcase


🚀 Quick Start

📥 Option 1: Download App (Recommended)

Get the latest installer for your OS from the Releases Page.

Note

macOS Notice: If you see a "Damage" or "Unidentified Developer" warning, run:

xattr -cr /Applications/Q-Solver.app
chmod +x /Applications/Q-Solver.app/Contents/MacOS/Q-Solver

🛠️ Option 2: Build from Source

Prerequisites: Go 1.25+, Node.js 22+, Wails CLI

# 1. Install Wails
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# 2. Clone repo
git clone https://github.com/jym66/Q-solver.git
cd Q-Solver

# 3. Dev mode (Hot Reload)
wails dev

# 4. Build Production
wails build -ldflags "-s -w" -tags prod

⌨️ Shortcuts

💡 Tip: Shortcuts are currently fixed on macOS. Windows supports custom shortcuts (defaults below).

Action Windows macOS
Snapshot & Solve 📸 F8 ⌘ + 1
Toggle Visibility 👁️ F9 ⌘ + 2
Toggle Click-Through 👻 F10 ⌘ + 3
Nudge Window ↕️ Alt + Arrows ⌘⌥ + Arrows
Fast Scroll 📜 Alt + PgUp/Dn ⌘⌥⇧ + ↑/↓

⚙️ Configuration

  1. Click the Settings icon (top-right).
  2. Select text Provider (e.g., Gemini, OpenAI).
  3. Paste your API Key.
  4. (Optional) Enable Live API for voice features.

🍎 macOS Setup

macOS requires specific permissions for full functionality:

🔐 Screen Recording (Required)

For screen analysis:

  1. You should see a system prompt on first launch.
  2. If not, go to System Settings -> Privacy & Security -> Screen Recording.
  3. Toggle Q-Solver ON.
  4. Restart the app.
🎙️ System Audio Capture (For Live API)

To let the AI hear computer audio (e.g., meetings), you need a virtual audio driver:

  1. Install BlackHole: 
    brew install blackhole-2ch
  2. Open Audio MIDI Setup.
  3. Create a Multi-Output Device. Check both your Speakers and BlackHole 2ch.
  4. Set this Multi-Output Device as your system output.
  5. In Q-Solver Settings, ensure Audio Input includes BlackHole.

🛠️ Tech Stack

  • Core: Go (Logic) + Wails (Binding)
  • UI: Vue 3 + Vue Flow (Mind Map)
  • AI: Gemini Protocol, OpenAI SDK
  • Audio: Miniaudio (via malgo), BlackHole

📈 Star History


📄 License

Distributed under the CC BY-NC 4.0 License. Intended for personal, non-commercial use only.

Made with ❤️ by jym66

If you enjoy using Q-Solver, please leave a ⭐ Star!