An open API service indexing awesome lists of open source software.

https://github.com/goyam02/prep_wise

Prep.AI is an AI-powered platform to help users simulate real interview experiences through interactive voice conversations.
https://github.com/goyam02/prep_wise

day-js devicons firebase fullstack fullstack-development gemini-api interview interview-practice interview-preparation lucide-icons lucide-react nextjs radix-ui react sonner typescript vapi-ai vercel-deployment

Last synced: 29 days ago
JSON representation

Prep.AI is an AI-powered platform to help users simulate real interview experiences through interactive voice conversations.

Awesome Lists containing this project

README

          

# ๐ŸŽ™๏ธ Prep.AI โ€“ Voice-Driven AI Interview Generator

[![Built with React](https://img.shields.io/badge/Built%20with-React-61DAFB?logo=react)](https://reactjs.org/)
[![Powered by Firebase](https://img.shields.io/badge/Powered%20by-Firebase-FFCA28?logo=firebase)](https://firebase.google.com/)
[![Hosted on Vercel](https://img.shields.io/badge/Hosted%20on-Vercel-black?logo=vercel)](https://vercel.com/)
[![AI by Gemini](https://img.shields.io/badge/AI%20Powered%20by-Gemini-4285F4?logo=google)](https://deepmind.google/technologies/gemini/)
[![Voice by Vapi](https://img.shields.io/badge/Voice%20Agent-Vapi%20AI-blueviolet)](https://vapi.ai)

[๐Ÿš€ **Live Demo**](https://prep-ai-tan.vercel.app)

---

## ๐Ÿง  What is Prep.AI?

Prep.AI is an AI-powered platform to help users **simulate real interview experiences** through **interactive voice conversations**.

It uses:
- ๐ŸŽค **Vapi AI** for voice interaction,
- ๐Ÿค– **Gemini AI** to dynamically generate personalized interview questions,
- โ˜๏ธ **Firebase** to store sessions, answers, and feedback.

Whether you're preparing for your next tech job or just want to boost your communication skills, Prep.AI gives you hands-on practice with **realistic AI interviewers**.

---

## โœจ Features

- ๐ŸŽ™๏ธ **Voice-Driven Interviews** with Vapi AI
- ๐Ÿง  **Dynamic Question Generation** via Gemini
- ๐Ÿ“‹ **Instant Interview Feedback**
- ๐Ÿ“‚ **View Previous Interview Reports**
- โ˜๏ธ **Firebase-Powered Database & Auth**
- ๐Ÿš€ **Deployed Seamlessly with Vercel**
- ๐Ÿ“ฑ Fully **responsive UI** with smooth UX

---

## ๐Ÿงฑ Tech Stack

| Technology | Purpose |
|------------------|------------------------------------------|
| Vapi AI | Real-time voice agent for conversations |
| Gemini API | Generates domain-specific questions |
| Firebase | Realtime database + Authentication |
| React + Next.js | Frontend UI and API routes |
| Tailwind CSS | Utility-first CSS for styling |
| Vercel | Deployment + Hosting |

---

## ๐Ÿ“‚ Folder Structure
```
Prep_Wise/
โ”‚
โ”œโ”€โ”€ app/ # Application routes (Next.js App Router)
โ”œโ”€โ”€ components/ # Reusable UI components (e.g., cards, layout)
โ”œโ”€โ”€ constants/ # Static constants and config values
โ”œโ”€โ”€ firebase/ # Firebase setup and helper functions
โ”œโ”€โ”€ lib/ # Utility functions (e.g., Gemini, Vapi logic)
โ”œโ”€โ”€ public/ # Static assets (icons, images, manifest)
โ”œโ”€โ”€ types/ # TypeScript types and interfaces
โ”‚
โ”œโ”€โ”€ .idea/ # IDE-specific settings (optional)
โ”œโ”€โ”€ .gitignore # Git ignored files
โ”œโ”€โ”€ README.md # Project documentation
โ”œโ”€โ”€ package.json # NPM dependencies and scripts
โ”œโ”€โ”€ tsconfig.json # TypeScript configuration
โ”œโ”€โ”€ next.config.ts # Next.js project configuration
โ”œโ”€โ”€ postcss.config.mjs # PostCSS config for Tailwind
โ”œโ”€โ”€ eslint.config.mjs # ESLint setup
```

---

## โš™๏ธ .env.local Example

Hereโ€™s a sample of the environment variables you might need to run the project:

```env
# Firebase Admin SDK
FIREBASE_PROJECT_ID="your_project_id"
FIREBASE_PRIVATE_KEY="your_private_key"
FIREBASE_CLIENT_EMAIL="your_client_email"

# Gemini (Google Generative AI)
GOOGLE_GENERATIVE_AI_API_KEY="your_gemini_api_key"

# Vapi AI (Voice Agent)
NEXT_PUBLIC_VAPI_WEB_TOKEN="your_vapi_web_token"
NEXT_PUBLIC_VAPI_WORKFLOW_ID="your_vapi_workflow_id"
```

---

## ๐Ÿš€ Getting Started Locally

```
# 1. Clone the repository
https://github.com/Goyam02/Prep_Wise.git
cd Prep_Wise

# 2. Install dependencies
npm install

# 3. Add environment variables
cp .env.example .env.local
# Fill in your API keys and config

# 4. Start development server
npm run dev
```

---

## ๐Ÿ”ฎ Upcoming Features
โ€ข ๐Ÿ“Š Analytics Dashboard โ€“ visualize your improvement over time
โ€ข ๐Ÿงฉ Topic-specific Interviews โ€“ e.g., DSA, system design, HR
โ€ข ๐Ÿ” Re-attempt Previous Interviews
โ€ข ๐Ÿ“ค Export Feedback as PDF

---

## ๐Ÿค Contributing

- Pull requests and feedback are welcome!
1. Fork the repository
2. Create your feature branch: git checkout -b feature/feature-name
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin feature/feature-name
5. Open a pull request

---

## ๐Ÿ“ฌ Contact

Made with ๐Ÿ’™ by [GOYAM JAIN](https://github.com/Goyam02/)
- ๐ŸŒ [LinkedIn](www.linkedin.com/in/goyam02)
- ๐Ÿ“ง goyamjain02@gmail.com

## ๐ŸŒŸ Show Your Support
```
If you like this project:

โญ Star the repository
๐Ÿ” Share with your network
๐Ÿ—ฃ๏ธ Give feedback or contribute!