AI Interview Assistant

Chrome extension that helps answer interview questions with AI in real-time through a floating overlay.

Key Features

Auto Detection: Automatically detects interview questions from various platforms
AI-Powered: Generate answers using OpenAI GPT or Google Gemini
Floating Overlay: Interface that can be locked and positioned over the screen
Real-time: Works in real-time during interview sessions
Platform Support: Supports HireVue, myInterview, Spark Hire, and other platforms
Multi-language: Indonesian and English language support

Installation

Method 1: From Source Code

Download or clone this repository
Open Chrome and navigate to chrome://extensions/
Enable "Developer mode" in the top right corner
Click "Load unpacked" and select this project folder
Extension will appear in Chrome toolbar

Method 2: From Chrome Web Store

(Available after publication)

How to Run

Prerequisites

Google Chrome browser (version 88 or higher)
Valid API key from OpenAI or Google Gemini
Internet connection

Step-by-Step Installation and Setup

1. Install the Extension

# Clone the repository
git clone https://github.com/nerufuyo/neruanswer.git
cd neruanswer

# Or download ZIP and extract

2. Load Extension in Chrome

Open Chrome and go to chrome://extensions/
Enable Developer mode (toggle in top-right corner)
Click "Load unpacked" button
Select the neruanswer folder
Extension icon should appear in toolbar

3. Configure API Key

Click the extension icon in Chrome toolbar
Select AI provider (OpenAI or Gemini)
Enter your API key:
- OpenAI: Create account at OpenAI → API Keys
- Gemini: Get key from Google AI Studio
Click Test button to verify key works
Enable the extension with main toggle

4. Test the Extension

Navigate to any supported interview platform
The extension should show green indicator for supported platforms
Try manual detection with "Detect Question" button
Overlay should appear in top-right corner

Quick Start Guide

Enable Extension: Click toolbar icon → toggle ON
Visit Interview Site: Go to HireVue, myInterview, etc.
Start Interview: Begin your practice or real interview
Auto Detection: Questions will be detected automatically
Get AI Answers: Answers appear in floating overlay
Copy & Use: Click copy button to get answer text

Initial Setup

Click extension icon in Chrome toolbar
Choose AI Provider: OpenAI or Google Gemini
Enter API Key:
- OpenAI: Get from platform.openai.com
- Gemini: Get from Google AI Studio
Test API Key by clicking test button
Enable extension with main toggle
Configure preferences as needed

Environment Configuration

Copy .env.example file to .env and adjust configuration:

cp .env.example .env

Edit .env file as needed:

AI_PROVIDER=openai
OPENAI_API_KEY=your_api_key_here
DEFAULT_LANGUAGE=en
AUTO_DETECT_QUESTIONS=true

Development Setup (For Developers)

Local Development

# 1. Clone and setup
git clone https://github.com/nerufuyo/neruanswer.git
cd neruanswer

# 2. Configure environment
cp .env.example .env
# Edit .env file with your API keys

# 3. Load in Chrome
# - Go to chrome://extensions/
# - Enable Developer mode
# - Click "Load unpacked"
# - Select neruanswer folder

Testing and Debugging

# Enable debug mode in .env
DEBUG_MODE=true

# Test on platforms:
# - HireVue: hirevue.com
# - myInterview: myinterview.com  
# - Spark Hire: spark-hire.com

Building for Distribution

# Create production build
zip -r neruanswer-v1.0.zip . -x "*.git*" "*.env*" "node_modules/*" "*.DS_Store*"

How to Use

Automatic Mode (Recommended)

Open interview platform (HireVue, myInterview, etc.)
Activate extension through popup or click icon
Overlay will appear in top right corner
Extension will automatically detect new questions
AI answer will appear in overlay within seconds

Manual Mode

Activate extension
Click "Detect Question" in popup to force detection
Or click "Regenerate" in overlay for new answer

Overlay Controls

Minimize: Minimize/maximize overlay
Lock/Unlock: Lock/unlock overlay position
Close: Hide overlay
Copy: Copy answer to clipboard
Regenerate: Generate new answer

Supported Platforms

Fully Supported

HireVue
myInterview
Spark Hire
VidCruiter
Talview
Interview.com

Partially Supported

Zoom (requires manual detection)
Google Meet (requires manual detection)
Microsoft Teams (requires manual detection)

Not Supported

Platforms with heavy encryption
Platforms that block extensions

Troubleshooting

Extension Not Appearing

Make sure extension is activated in popup
Refresh interview page
Check if platform is supported

Not Detecting Questions

Click "Detect Question" in popup
Make sure question is clearly visible on screen
Try scrolling or clicking question area

Failed to Generate Answer

Check API key is correct
Test API key in popup
Make sure internet connection is available
Check API quota limits

Overlay Not Appearing

Click extension icon and activate
Refresh page
Check if overlay is minimized

Common Setup Issues

"Extension Not Loading"

# Solution:
1. Make sure you selected the correct folder (neruanswer)
2. Check that manifest.json exists in the folder
3. Disable other interview-related extensions
4. Restart Chrome if needed

"API Key Invalid"

# For OpenAI:
1. Visit https://platform.openai.com/api-keys
2. Create new API key
3. Make sure you have billing set up
4. Copy key exactly (starts with sk-)

# For Gemini:
1. Visit https://makersuite.google.com/app/apikey  
2. Create API key for Gemini
3. Enable Generative AI API in Google Cloud

"Questions Not Detected"

# Solutions:
1. Check if website is supported (see platform list)
2. Try manual detection button
3. Make sure question text is visible on screen
4. Check browser console for errors (F12)

"Permission Denied Errors"

# Solution:
1. Make sure extension has permissions
2. Check chrome://extensions/ settings
3. Enable "Allow in incognito" if needed
4. Restart browser after permission changes

Advanced Configuration

AI Settings

{
  "aiProvider": "openai",
  "apiKey": "your-api-key",
  "responseLanguage": "en",
  "maxResponseLength": 200
}

Overlay Settings

{
  "overlayPosition": { "x": 20, "y": 20 },
  "overlayLocked": false,
  "autoDetect": true
}

Privacy & Security

Local Storage: All data stored locally in browser
No Data Sharing: No data sent to third-party servers
API Keys: Stored encrypted in local storage
Question History: Only stored locally, can be deleted anytime

Contributing

Contributions are welcome! Please:

Fork repository
Create feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Create Pull Request

Changelog

v1.0.0 (2024-12-XX)

Initial release
Support for major interview platforms
AI integration with OpenAI and Gemini
Floating overlay with drag & drop
Auto-detection of questions
Multi-language support

License

MIT License - see LICENSE file for details.

Disclaimer

This extension is created for learning purposes and interview practice. Please ensure usage complies with the policies of the interview platform being used. The developer is not responsible for misuse of this extension.

Support

Issues: GitHub Issues
Documentation: Wiki
Email: support@neruanswer.com

Made with care for interview preparation

Neruanswer

Install / Use

README