CI
ClueInterview
Download Now

Documentation

Everything you need to get started with ClueInterview

Getting Started

ClueInterview is a desktop application designed to help anyone prepare for or conduct technical interviews with AI assistance. Whether you're a candidate preparing for your next role or an interviewer wanting to improve your process, this guide will walk you through the setup.

Who can use ClueInterview?

  • • Job Candidates: Practice technical interviews and get AI-powered feedback
  • • Interviewers: Conduct structured interviews with transcription and analytics
  • • Coding Bootcamp Students: Prepare for graduation interviews
  • • Career Switchers: Build confidence in technical interviews
  • • HR Professionals: Standardize your interview process

Before you begin:

  • • Ensure you have a microphone and speakers/headphones
  • • Have your resume ready in text or PDF format (optional)
  • • Check your internet connection for cloud transcription and AI features
  • • Prepare an API key for your preferred AI provider (OpenAI, Google Gemini, etc.)

Installation

ClueInterview is available for Windows, macOS, and Linux. Choose your platform below for detailed installation instructions.

Windows

Windows users can download the pre-built installer for the quickest setup.

  1. Download ClueInterview-Setup-1.2.0.exe from the download page
  2. Run the installer and follow the installation wizard
  3. Accept the default installation location or customize it
  4. Launch ClueInterview from your desktop or Start menu
  5. Configure your resume and AI settings on first launch

Note: Windows Defender may flag the executable. Click "More info" then "Run anyway" if prompted.

macOS

macOS users can download pre-built binaries or build from source.

Option 1: Download Pre-built Application

  1. Download the .dmg file from the download page or releases page
  2. Open the .dmg file and drag ClueInterview to Applications folder
  3. Open Applications and double-click ClueInterview to launch
  4. If you see "cannot be opened because it is from an unidentified developer", right-click and select "Open"

Option 2: Build from Source

  1. Install Node.js 18+ from nodejs.org
  2. Clone the repository:git clone https://github.com/Iamholak/clueinterview.git && cd clueinterview
  3. Install dependencies:npm install
  4. Build for macOS:npm run build:mac
  5. Launch the app:npm start

Linux

Linux users can download AppImage files or build from source.

Option 1: AppImage (Recommended)

  1. Download the .AppImage from the download page or releases page
  2. Make it executable:chmod +x ClueInterview-*.AppImage
  3. Run the application:./ClueInterview-*.AppImage

Option 2: Build from Source

  1. Install dependencies:sudo apt-get install nodejs npm git python3 build-essential
  2. Clone the repository:git clone https://github.com/Iamholak/clueinterview.git && cd clueinterview
  3. Install npm packages:npm install
  4. Build for Linux:npm run build:linux
  5. Launch:npm start

Troubleshooting: If AppImage won't run, try fuse installation: sudo apt-get install libfuse2

Building from Source

For advanced users or those on unsupported platforms, you can build ClueInterview directly from the source code. This provides full control over the build process and allows you to modify the application.

Why Build from Source?

  • • Get the latest development version before official releases
  • • Customize the application to your needs
  • • Contribute to the project development
  • • Deploy on your own infrastructure

Prerequisites

Before building, ensure you have installed:

  • •Node.js 18+ - Download from nodejs.org
  • •Git - Version control system for cloning the repository
  • •Build Tools - Compiler and build utilities for your platform

Step-by-Step Build Guide

1. Clone the Repository

git clone https://github.com/Iamholak/clueinterview.git && cd clueinterview

2. Install Dependencies

npm install

This downloads all required packages and may take a few minutes.

3. Configure Environment (Optional)

If you want to customize API keys or settings:

cp .env.example .env

Edit the .env file with your preferred settings.

4. Build the Application

Choose the command for your platform:

macOS:

npm run build:mac

Linux:

npm run build:linux

Windows:

npm run build:win

5. Run the Application

npm start

This will launch ClueInterview in development mode.

Development Mode

To run ClueInterview in development mode (useful for debugging or contributing):

npm run dev

This starts the development server with hot-reload enabled. Changes to the code will automatically refresh the application.

Troubleshooting Build Issues

  • Build fails: Ensure Node.js 18+ is installed and npm cache is clean (npm cache clean --force)
  • Native modules error: You may need build tools. On Windows, install Visual Studio Build Tools. On Mac/Linux, install build-essential.
  • Port already in use: Change the port by setting PORT=3001 npm start

Resume Setup

Your resume helps the AI ask relevant questions tailored to your experience and skills.

Adding Your Resume

  1. Open ClueInterview and navigate to the Profile tab
  2. Click on the "Resume" section
  3. Paste your resume content in the text area
  4. Click Save to store your resume locally

Tip:

Include your professional summary, key skills, work experience, and projects. The AI will use this information to generate relevant interview questions.

Interview Settings

Configure ClueInterview to match your preferences and requirements.

Transcription Engine

Choose between cloud transcription for higher accuracy or built-in transcription for local processing.

  • Cloud Transcription: Uses cloud API for better accuracy, requires internet
  • Built-in: Processes transcription locally, no internet required

Stealth Mode

When enabled, your interview window is hidden from screen shares. Only others see what you want them to see.

AI Provider

Configure your preferred AI model and provider (OpenAI, Google Gemini, etc.) for interview questions.

Keyboard Shortcuts

Speed up your workflow with these keyboard shortcuts:

SpaceSend message
Ctrl/Cmd + KClear chat
Ctrl/Cmd + Shift + HHide/Show app on screen
Ctrl/Cmd + LToggle code block
EscapeClose settings

Troubleshooting

Having issues? Check these common solutions:

Audio not working

Check that your microphone is connected and enabled in system settings. Restart ClueInterview and try again.

Transcription errors

Ensure your microphone is working properly and you're speaking clearly. Try switching between transcription engines in settings.

App crashes on startup

Try reinstalling the application. Remove the config files from ~/.clueinterview and restart.

AI not responding

Check your internet connection and verify your AI API key is configured correctly in settings.

Still need help?

Check out the GitHub issues or contact our support team.

View GitHub Issues →