MCQ Study Assistant

A visible Electron study app that analyzes MCQ screenshots with GROQ vision models and returns a likely answer with a short explanation.

This project is designed for learning: npm CLI packaging, Electron windows, renderer/main process IPC, image handling, and GROQ API integration.

Features

• Select a screenshot/image from your computer
• Paste an image from the clipboard with Ctrl+V
• Analyze the loaded or clipboard image with Alt+V while the app is focused
• Show a temporary transparent answer popup in the center of the screen
• Send the image to GROQ's vision model
• Show the likely answer and reasoning in the app
• Package as a global command: mcq-study

Install

npm install

Configure API Key

Copy the example config:

copy src\config.example.js src\config.js

Then edit src/config.js:

module.exports = {
  GROQ_API_KEY: 'gsk_your_key_here',
  GROQ_MODEL: 'meta-llama/llama-4-scout-17b-16e-instruct'
};

Do not publish or commit your real API key.

Run

npm start

Test With The Hotkey

1. Start the app with npm start.
2. Copy an MCQ image to your clipboard, or capture one with Win+Shift+S.
3. Click the MCQ Study Assistant window so it is focused.
4. Press Alt+V.
5. The app analyzes the image and shows a centered transparent answer popup for 5 seconds.

If you already loaded an image with Choose Image, Alt+V analyzes that loaded image.

Test

npm test

Use As A Global CLI During Development

npm link
mcq-study

Project Structure

mcq-study-assistant/
├── index.js
├── package.json
├── README.md
├── src/
│   ├── appWindow.js
│   ├── config.example.js
│   ├── groqClient.js
│   ├── imageInput.js
│   ├── ipc.js
│   ├── renderer.js
│   ├── styles.css
│   ├── utils.js
│   └── index.html
└── test/
    ├── test-groq-config.js
    └── test-utils.js

Notes

This app intentionally requires visible user action. The Alt+V shortcut works while the MCQ Study Assistant app is focused.