Clueless

"Cluely but the inerviewer wont have a clue."

Clueless is a discreet tool that helps you during assessments or interviews. Simply map a keybinding (e.g., SUPER + S), and when pressed, it will:

1. Take a screenshot of your current screen.
2. Send the screenshot to the Gemini API for analysis.
3. Display the response as a system notification.

This allows you to quickly get information or answers without being detected by recruitment systems.

Installation

1. Clone the repository:

   git clone https://github.com/oscarmuya/clueless.git
   cd clueless

2. Install Poetry: If you don't have Poetry installed, follow the instructions on the official Poetry website.

3. Install dependencies:

   poetry install

4. Platform-specific dependencies:

   • Linux: This script uses grim to take screenshots. Please install it using your package manager (e.g., sudo apt-get install grim or sudo pacman -S grim).
   • Windows/macOS: The script will use built-in tools.

Configuration

1. Create a .env file: Copy the .env.template file to a new file named .env.

   cp .env.template .env

2. Add your Gemini API Key: Open the .env file and add your Gemini API key.

   GEMINI_API_KEY=your_gemini_api_key_here
   LLM_MODEL_ID=gemini/gemini-flash-latest
   

   You can obtain a Gemini API key from Google AI Studio.

Usage

The intended use of this application is to run it via a global keybinding. Below are examples for different operating systems.

First, you need to find the path to the Python executable within your poetry virtual environment. You can find this by running the following command in your project directory:

poetry env info --path

This will output the path to your virtual environment. The python executable will be in the bin subdirectory of that path. For example: /home/oscar/.cache/pypoetry/virtualenvs/scrnshot-Rh_LDw8C-py3.13/bin/python.

Linux (Sway/i3/Hyprland)

Edit your window manager's configuration file (e.g., ~/.config/sway/config, ~/.config/i3/config, ~/.config/hypr/hyprland.conf).

Add a line similar to this, replacing the path with the one you found above:

Sway/i3:

bindsym SUPER+S exec /home/oscar/.cache/pypoetry/virtualenvs/scrnshot-Rh_LDw8C-py3.13/bin/python /home/oscar/Documents/llm/scrnshot/run.py

Hyprland:

bind = SUPER, S, exec, /home/oscar/.cache/pypoetry/virtualenvs/scrnshot-Rh_LDw8C-py3.13/bin/python /home/oscar/Documents/llm/scrnshot/run.py

Windows

1. Install AutoHotkey: Download and install AutoHotkey.

2. Create a script: Create a new file named clueless.ahk with the following content. Replace the python executable path and script path with your own.

   ; Super + S
   #s::
   {
       Run, "C:\path\to\your\poetry\virtualenv\Scripts\python.exe C:\path\to\your\Clueless\run.py"
       return
   }

3. Run the script: Double-click the clueless.ahk file to run it in the background.

macOS

1. Open Automator: You can find it in your Applications folder.

2. Create a new "Quick Action":

3. Configure the Quick Action:

   • Set "Workflow receives current" to "no input".
   • Add a "Run Shell Script" action.
   • Paste the following code into the script area, replacing the paths with your own:

     /Users/your-user/.cache/pypoetry/virtualenvs/scrnshot-Rh_LDw8C-py3.13/bin/python /Users/your-user/Documents/llm/scrnshot/run.py

4. Save the Quick Action: Save it with a name like "Run Clueless".

5. Assign a keyboard shortcut:

   • Go to System Settings > Keyboard > Keyboard Shortcuts... > Services.
   • Find your "Run Clueless" service under the "General" section.
   • Click on it and add a shortcut (e.g., Cmd + Shift + S).