Skip to content

Ahmadjamil888/AI_INTERVIEWER_MVP

Repository files navigation

AI Interview Assistant

A full-stack AI-powered interview assistant that helps candidates during live interviews by providing real-time transcription and intelligent response suggestions.

🚀 Features

Desktop Application (.exe)

  • Stealth Mode: Invisible during screen sharing
  • Real-time Transcription: Live audio capture and speech-to-text
  • AI-Powered Responses: Gemini Pro API integration for smart suggestions
  • Floating UI: Minimalist circular button with expandable chat panel
  • Interview History: Clean Q&A history for review
  • Local Settings: Dark/light mode, stealth toggles

Web Application

  • Authentication: Secure login with Clerk
  • Dashboard: Download links and API key management
  • Usage Analytics: Basic stats and feedback system
  • Responsive Design: Modern UI with Tailwind CSS

📦 Project Structure

/
├── desktop-app/          # Electron + React desktop application
├── web-app/             # Next.js web application
├── .env.template        # Environment variables template
└── README.md           # This file

🛠️ Installation & Setup

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Windows (for .exe build)

Desktop App Setup

cd desktop-app
npm install
npm run dev          # Development mode
npm run build        # Build for production
npm run dist         # Create .exe installer

Web App Setup

cd web-app
npm install
cp .env.template .env.local
# Add your API keys to .env.local
npm run dev          # Development mode
npm run build        # Build for production

🔑 Environment Variables

Desktop App (.env)

GEMINI_API_KEY=your_gemini_api_key_here

Web App (.env.local)

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
GEMINI_API_KEY=your_gemini_api_key
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
STRIPE_SECRET_KEY=your_stripe_secret_key

🚀 Deployment

Desktop App

  1. Run npm run dist to create Windows installer
  2. Distribute the generated .exe file

Web App

  1. Deploy to Vercel, Netlify, or your preferred platform
  2. Set environment variables in your deployment platform
  3. Configure Clerk authentication domains

🔒 Security Features

  • API keys stored locally in desktop app
  • Secure authentication with Clerk
  • Screen sharing detection and UI hiding
  • Client-side audio processing

📱 Usage

  1. Web App: Sign up and get your API key
  2. Desktop App: Download and install the .exe
  3. Setup: Configure API key in desktop app settings
  4. Interview: Click floating button during interviews for assistance

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

📄 License

MIT License - see LICENSE file for details

Releases

No releases published

Packages

No packages published