Mock Minds

Mock Minds is an AI-powered mock interview platform designed to help users prepare for interviews by providing instant feedback. The platform utilizes modern technologies like Next.js, Tailwind CSS, Clerk for authentication, and Drizzle ORM for database management. Additionally, Mock Minds integrates the Gemini API for generating interview questions and providing intelligent feedback based on user responses.

Features

• AI Mock Interview: Conduct mock interviews with AI-generated questions using the Gemini API and receive real-time feedback.
• User Authentication: Secure sign-up and login powered by Clerk.
• Question & Feedback Generation: Leverage the Gemini API to dynamically generate interview questions and provide detailed feedback.
• Real-Time Speech Recognition: Implemented with react-hook-speech-to-text for hands-free user responses.
• Webcam Integration: Uses react-webcam to simulate real interview settings.
• Responsive Design: Styled using Tailwind CSS with custom animations.

Tech Stack

• Frontend: Next.js, React, Tailwind CSS
• Authentication: Clerk
• Database: Drizzle ORM, Neon (serverless PostgreSQL)
• AI Question & Feedback: Gemini API
• Speech Recognition: react-hook-speech-to-text
• UI Components: Radix UI, TailwindCSS Forms, Shadcn UI

Getting Started

Prerequisites

• Node.js (>= 14.x)
• Neon Database account
• Clerk account for authentication
• Access to Gemini API

Installation

1. Clone the repository:

   git clone https://github.com/your-username/mock-minds.git
   cd mock-minds

2. Install dependencies:

   npm install

3. Set up environment variables:

   Create a .env.local file in the root directory and add your Clerk, Neon Database, and Gemini API credentials:

   NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
   CLERK_SECRET_KEY=your_clerk_secret_key
   NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
   NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
   NEXT_PUBLIC_DRIZZLE_DB_URL=your_neon_db_url
   GEMINI_API_KEY=your_gemini_api_key
   NEXT_PUBLIC_MAX_QUESTIONS=10

4. Run the development server:

   npm run dev

5. Open http://localhost:3000 to view the application.

Usage

1. Register or log in using Clerk.
2. Start a mock interview session where questions are generated dynamically by the Gemini API.
3. Answer questions using speech or text input.
4. Review feedback provided by the Gemini API after each question and improve your performance.

Contributing

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes.
4. Commit your changes (git commit -am 'Add new feature').
5. Push to the branch (git push origin feature-branch).
6. Create a new Pull Request.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

For any inquiries or issues, please reach out to [email protected].