🎯 RoundZero - Ace Every Interview with AI

RoundZero is a premium, AI-powered interview preparation platform that helps candidates practice with an adaptive AI interviewer. It analyzes your resume, asks intelligent follow-up questions, and provides real-time, honest feedback to help you land your dream job.

✨ Key Features

• 🧠 Adaptive AI Interviewer: Practice with an AI that understands your background and challenges you like a real recruiter.
• 📄 Resume-Driven: The AI adapts its questions based on your specific experience and skills extracted from your resume.
• 🎙️ AI Voice Interviews: Real-time voice interaction for a more immersive and realistic practice experience.
• 📊 Real-time Feedback: Get instant scores and detailed feedback on your answers (e.g., Star Method evaluation).
• 📋 Personalized Reports: Comprehensive post-interview reports to track your progress and identify areas for improvement.
• ⚡ Premium UI/UX: A sleek, modern dashboard with dark mode and smooth animations.

🚀 Tech Stack

• Framework: Next.js 16 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS 4, Framer Motion
• Database: PostgreSQL with Prisma ORM
• Authentication: better-auth
• API Layer: oRPC (End-to-end type-safe API)
• AI Engine: Google Gemini API via Vercel AI SDK
• Audio Processing: Deepgram SDK
• Storage: AWS S3
• Formatting: Biome

🛠️ Getting Started

Prerequisites

• Node.js (version 20 or higher)
• pnpm (recommended) or npm
• PostgreSQL database

Installation

1. Clone the repository:

   git clone https://github.com/theeaashish/RoundZero.git
   cd RoundZero

2. Install dependencies:

   pnpm install

3. Set up environment variables: Copy .env.example to .env and fill in the required values.

   cp .env.example .env

4. Initialize the database:

   pnpm db:push
   pnpm db:generate

5. Run the development server:

   pnpm dev

6. Open http://localhost:3000 in your browser.

🔑 Environment Variables

Make sure to configure the following in your .env:

Variable	Description
DATABASE_URL	Your PostgreSQL connection string
BETTER_AUTH_SECRET	Secret for better-auth
GEMINI_API_KEY	Your Google Gemini API Key
DEEPGRAM_API_KEY	Your Deepgram API Key
GITHUB_CLIENT_ID/SECRET	GitHub OAuth credentials
GOOGLE_CLIENT_ID/SECRET	Google OAuth credentials
S3_BUCKET_NAME	AWS S3 Bucket Name
AWS_ACCESS_KEY_ID/SECRET	AWS credentials

📂 Project Structure

• src/app/ - Next.js App Router (Marketing, Auth, Dashboard)
• src/components/ - Reusable UI components (shadcn/ui)
• src/lib/ - Shared utilities and library initializations (Prisma, Gemini, etc.)
• src/server/ - oRPC routers and server-side logic
• src/config/ - Environment and application configuration
• prisma/ - Database schema and migrations

📜 Scripts

• pnpm dev - Start development server
• pnpm build - Build for production
• pnpm lint - Run Biome check
• pnpm format - Run Biome format
• pnpm db:push - Push schema changes to database
• pnpm db:studio - Open Prisma Studio

---

Built with ❤️ by [RoundZero Team]