Intervu

A free, open-source, "Bring Your Own Key" (BYOK) platform for comprehensive interview preparation.

Why Intervu?

Most AI interview preparation tools charge monthly subscriptions ($20-$50/mo) just to wrap API calls you could make yourself. Intervu is different:

• Free & Open Source: No subscriptions. Self-host it or run it locally.
• Privacy First: Your API keys are stored in your browser's local storage (encryped).
• Bring Your Own Key (BYOK): Plug in your own OpenAI, Anthropic, Gemini, or Groq keys. Pay the provider directly for exactly what you use.
• Groq Integration: Experience near-instant voice-to-text and response times for realistic mock interviews.

Features

• 🚀 Panic Mode: A one-click preset for last-minute prep (15 mins before the interview). Generates high-yield cheat sheets.
• ⚡ Real-time Mock Interviews: Voice-enabled AI interviewer that adapts to your responses.
• 📝 Resume Tailoring: Paste a job description URL and get specific, actionable advice on how to tailor your resume.
• 🏢 Company Recon: Automatically fetches company news, financials, stock performance, and "vibe" analysis.
• 🧠 System Design Bank: Dedicated module for architecture questions (e.g., "Design Instagram").
• 🔒 Secure: Keys are encrypted at rest and never shared.

Tech Stack

• Framework: Next.js 14 (App Router)
• Database: Supabase (PostgreSQL + Auth)
• Styling: Tailwind CSS + Shadcn UI
• AI: Integration with OpenAI, Google Gemini, Anthropic, and Groq (Llama 3).
• Icons: Phosphor Icons

Getting Started

Prerequisites

• Node.js 18+
• A Supabase account (free tier works great)
• API Keys for at least one provider (Groq recommended for speed, OpenAI for quality)

Installation

1. Clone the repository

   git clone https://github.com/vvknyn/interview-os.git
   cd interview-os

2. Install dependencies

   npm install
   # or
   pnpm install

3. Set up Supabase

   • Create a new project on Supabase.
   • Run the SQL migrations (found in supabase/migrations or just use the dashboard to create necessary tables if migrations are not included - Note: Schema details coming soon).
   • Get your NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_KEY (Anon).

4. Configure Environment Variables

   • Copy the example env file:

     cp .env.example .env.local

   • Fill in your Supabase credentials.
   • Generate a random 32-byte hex string for ENCRYPTION_KEY:

     openssl rand -hex 32

5. Run the development server

   npm run dev

   Open http://localhost:3000 with your browser.

Deployment

The easiest way to deploy is using Vercel.

1. Push your code to a GitHub repository.
2. Import the project into Vercel.
3. Add the environment variables from your .env.local to the Vercel project settings.
4. Deploy!

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.