Note: GZAssist is in active development. Some features may be incomplete or change frequently.
GZAssist is a smart and lightweight desktop utility for Windows that uses screen captures as input for AI-powered insights — such as solving questions, explaining code, summarizing content, translating, and more.
No tab switching, no manual copy-paste — just hotkey, capture, and get answers directly in a floating overlay.
Ideal for developers, students, readers, or anyone needing fast context-aware assistance.
- Global hotkey activation (Ctrl + Alt + K)
- Fullscreen or active window capture
- AI modes (exam questions, explanation, summary, etc.)
- Clean floating overlay for quick responses
- Works without disrupting your workflow
| Mode | Description | Status |
|---|---|---|
| 📘 Exam Question | Solves multiple-choice questions with justification | ✅ Implemented |
| 💻 Code Debugger | Explains errors or code snippets | ✅ Implemented |
| 📖 Summarizer | Summarizes long texts or slides | ✅ Implemented |
| 🌍 Translator | Translates visible content | ✅ Implemented |
| 🔍 Auto Mode | AI decides the best action based on the captured image | ✅ Implemented |
| 🕵️♂️ Extra Mode | Hidden feature for programming challenges (explore!) | 🚧 In Progress |
You can add more modes or customize prompts as needed. There is at least one hidden "extra mode" focused on programming challenges.
-
Clone the repository:
git clone https://github.com/gzlabs/gzassist.git cd gzassist -
To build the project with all dependencies and create an executable "fat" JAR:
mvn clean package
The resulting file will be at
target/GZAssist.jar. -
Run the application:
java -jar target/GZAssist.jar
Note: Make sure you have Java 21 installed. Recommended JDK distributions with JavaFX included:
- Azul Zulu JDK with JavaFX 21 (https://www.azul.com/downloads)
- BellSoft Liberica Full JDK 21 (https://bell-sw.com)
- Liberica NIK 21 (Native Image Kit with JavaFX) > Alternatively, you can use any JDK 21 and Maven will handle the JavaFX dependencies.
Installers and binaries are already available under Releases.
Automated testing functionality will be available soon.
- 🧩 Action picker UI (choose AI mode)
- 🎨 Configurable overlay themes
- 📸 Local OCR support for offline mode
- 🕓 Local and searchable query history
- 🧠 Custom prompt templates per mode
- 🔐 API key wizard and local secure storage
- 🔊 Text-to-speech response (optional)
GZAssist — The invisible assistant that understands your screen. 🚀