{"id":31263840,"url":"https://github.com/huzaifa-fullstack/eduvox-ai","last_synced_at":"2026-04-07T07:02:57.859Z","repository":{"id":314080854,"uuid":"1052567026","full_name":"huzaifa-fullstack/eduvox-ai","owner":"huzaifa-fullstack","description":"EduVox AI is an AI-powered educational voice companion that delivers real-time tutoring across subjects with GPT-4, voice synthesis, speech recognition, secure auth, and a modern Next.js UI.","archived":false,"fork":false,"pushed_at":"2025-09-17T13:47:29.000Z","size":16611,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-17T15:37:55.233Z","etag":null,"topics":["clerk","deepgram","education","elevenlabs","javascript","lottie","nextjs","openai","radix-ui","react","sentry","superbase","svix","tailwind-css","typescript","vapi","vercel","voice-ai","webhooks","zod"],"latest_commit_sha":null,"homepage":"https://eduvox-ai.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huzaifa-fullstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-08T08:32:39.000Z","updated_at":"2025-09-17T13:47:32.000Z","dependencies_parsed_at":"2025-09-10T13:58:55.923Z","dependency_job_id":"6d16a253-f0b8-4523-af4f-21206cda8f45","html_url":"https://github.com/huzaifa-fullstack/eduvox-ai","commit_stats":null,"previous_names":["huzaifa-fullstack/eduvox-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/huzaifa-fullstack/eduvox-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzaifa-fullstack%2Feduvox-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzaifa-fullstack%2Feduvox-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzaifa-fullstack%2Feduvox-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzaifa-fullstack%2Feduvox-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huzaifa-fullstack","download_url":"https://codeload.github.com/huzaifa-fullstack/eduvox-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzaifa-fullstack%2Feduvox-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31503394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clerk","deepgram","education","elevenlabs","javascript","lottie","nextjs","openai","radix-ui","react","sentry","superbase","svix","tailwind-css","typescript","vapi","vercel","voice-ai","webhooks","zod"],"created_at":"2025-09-23T12:07:36.007Z","updated_at":"2026-04-07T07:02:57.854Z","avatar_url":"https://github.com/huzaifa-fullstack.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎓 EduVox AI – AI-Powered Educational Voice Companion Platform\n\n![EduVox AI](https://img.shields.io/badge/EduVox-AI%20Powered%20Education-blue?style=for-the-badge)\n![Next.js](https://img.shields.io/badge/Next.js-black?style=for-the-badge\u0026logo=next.js\u0026logoColor=white)\n![React](https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB)\n![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge\u0026logo=tailwindcss\u0026logoColor=white)\n![ShadCN UI](https://img.shields.io/badge/ShadCN_UI-000000?style=for-the-badge\u0026logo=shadcnui\u0026logoColor=white)\n![Supabase](https://img.shields.io/badge/Supabase-3ECF8E?style=for-the-badge\u0026logo=supabase\u0026logoColor=white)\n![Clerk](https://img.shields.io/badge/Clerk-6B46C1?style=for-the-badge\u0026logo=clerk\u0026logoColor=white)\n![Vapi AI](https://img.shields.io/badge/Vapi-AI%20Voice-FF6B6B?style=for-the-badge)\n![OpenAI](https://img.shields.io/badge/OpenAI-GPT--4-412991?style=for-the-badge\u0026logo=openai\u0026logoColor=white)\n![ElevenLabs](https://img.shields.io/badge/ElevenLabs-Voice%20AI-FF4500?style=for-the-badge)\n![Deepgram](https://img.shields.io/badge/Deepgram-Speech%20to%20Text-13D8BE?style=for-the-badge)\n![Sentry](https://img.shields.io/badge/Sentry-Error%20Tracking-362D59?style=for-the-badge\u0026logo=sentry\u0026logoColor=white)\n![React Hook Form](https://img.shields.io/badge/React%20Hook%20Form-EC5990?style=for-the-badge\u0026logo=reacthookform\u0026logoColor=white)\n![Radix UI](https://img.shields.io/badge/Radix%20UI-161618?style=for-the-badge\u0026logo=radix-ui\u0026logoColor=white)\n![Zod](https://img.shields.io/badge/Zod-3E67B1?style=for-the-badge\u0026logo=zod\u0026logoColor=white)\n![Lottie](https://img.shields.io/badge/Lottie-00D4AA?style=for-the-badge\u0026logo=lottiefiles\u0026logoColor=white)\n![Lucide](https://img.shields.io/badge/Lucide-Icons-F56565?style=for-the-badge\u0026logo=lucide\u0026logoColor=white)\n![Svix](https://img.shields.io/badge/Svix-Webhooks-6366F1?style=for-the-badge)\n![Vercel](https://img.shields.io/badge/Vercel-000000?style=for-the-badge\u0026logo=vercel\u0026logoColor=white)\n![JavaScript](https://img.shields.io/badge/JavaScript-323330?style=for-the-badge\u0026logo=javascript\u0026logoColor=F7DF1E)\n![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge\u0026logo=html5\u0026logoColor=white)\n![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=for-the-badge\u0026logo=css3\u0026logoColor=white)\n![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=nodedotjs\u0026logoColor=white)\n![PostCSS](https://img.shields.io/badge/PostCSS-DD3A0A?style=for-the-badge\u0026logo=postcss\u0026logoColor=white)\n![ESLint](https://img.shields.io/badge/ESLint-4B32C3?style=for-the-badge\u0026logo=eslint\u0026logoColor=white)\n![GitHub Actions](https://img.shields.io/badge/GitHub_Actions-2088FF?style=for-the-badge\u0026logo=githubactions\u0026logoColor=white)\n![CI/CD Pipeline](https://img.shields.io/badge/CI/CD-Automated-success?style=for-the-badge\u0026logo=githubactions\u0026logoColor=white)\n![Speed Insights](https://img.shields.io/badge/Speed_Insights-Performance_Monitoring-000000?style=for-the-badge\u0026logo=vercel\u0026logoColor=white)\n![MIT License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)\n![Project Status](https://img.shields.io/badge/Status-Active-success?style=for-the-badge)\n\n🌐 **Live Demo:** [Click here to visitsite](https://eduvox-ai.vercel.app/)\n\n## **Deployed on Vercel**\n\n---\n\n## 📋 Overview\n\n**EduVox AI** is a revolutionary **AI-powered educational platform** that creates personalized voice-based learning companions for students. It combines cutting-edge voice AI technology with educational expertise to deliver **interactive, real-time learning sessions** across multiple subjects.\n\nKey highlights include:\n\n- **Real-time voice conversations** with AI tutors using advanced speech synthesis and recognition\n- **Personalized AI companions** for Mathematics, Science, Language, History, Coding, and Economics\n- **Intelligent session management** with progress tracking and conversation limits\n- **Secure authentication** and user data management with automatic cleanup\n- **Modern, responsive UI** built with Next.js 15, React 19, and Tailwind CSS 4\n- **Scalable architecture** with real-time database and webhook integrations\n\n---\n\n## 🏗️ Features\n\n### 🤖 **AI-Powered Voice Companions**\n\n- **Subject-Specific Tutors** across 6 major academic areas\n- **Real-time Voice Interaction** with natural conversation flow\n- **Personalized Learning Paths** tailored to individual topics\n- **Multiple Voice Options** (Male/Female, Casual/Formal styles)\n- **Dynamic Session Duration** (1-60 minutes)\n\n### 🎯 **Educational Subjects**\n\n- **📊 Mathematics** - Calculus, Algebra, Statistics, and more\n- **🔬 Science** - Physics, Chemistry, Biology concepts\n- **📚 Language** - Literature, Grammar, Vocabulary building\n- **🏛️ History** - World events, Historical analysis\n- **💻 Coding** - Programming concepts, Logic building\n- **💰 Economics** - Market principles, Economic theory\n\n### 🎨 **Companion Customization**\n\n- **Custom Names** with content filtering\n- **Topic Specification** with relevance validation\n- **Voice Selection** (ElevenLabs AI voices)\n- **Teaching Style** (Casual or Formal approach)\n- **Session Duration** control\n\n### 📊 **Smart Session Management**\n\n- **Conversation Limits** (Free: 5/month, Premium: 50/month)\n- **Session History** tracking and analytics\n- **Bookmark System** for favorite companions\n- **Popular Companions** discovery\n- **Recent Sessions** quick access\n\n### 🔐 **Authentication \u0026 Security**\n\n- **Clerk Authentication** with OAuth support\n- **Secure User Management** with automatic data cleanup\n- **Webhook Integration** for account deletion handling\n- **GDPR Compliant** data processing\n- **Real-time Error Tracking** with Sentry\n\n### � **Performance Monitoring**\n\n- **Speed Insights** — Real-time Core Web Vitals tracking\n- **Performance Analytics** — Page load and interaction metrics\n- **User Experience Optimization** — Data-driven performance improvements\n- **Vercel Integration** — Seamless monitoring dashboard\n\n### �📱 **Modern UX/UI**\n\n- **Responsive Design** (Mobile-first approach)\n- **Lottie Animations** for enhanced user experience\n- **Form Validation** with real-time feedback\n- **Accessibility** optimized components\n- **ShadCN UI Components** — Beautiful, accessible, and customizable React UI elements\n\n---\n\n## 💻 Technologies Used\n\n### **Frontend Framework**\n\n- [**Next.js 15.5.2**](https://nextjs.org/) — React-based full-stack framework with App Router\n- [**React 19.1.0**](https://reactjs.org/) — Modern UI library with concurrent features\n- [**TypeScript 5**](https://www.typescriptlang.org/) — Type-safe JavaScript development\n\n### **Styling \u0026 UI Components**\n\n- [**Tailwind CSS 4**](https://tailwindcss.com/) — Utility-first CSS framework\n- [**Radix UI**](https://www.radix-ui.com/) — Accessible, unstyled UI primitives\n- [**ShadCN UI**](https://ui.shadcn.com/) — Beautiful, accessible React components built on Radix UI and Tailwind CSS\n- [**Class Variance Authority**](https://cva.style/) — Component variant management\n- [**Tailwind Merge**](https://github.com/dcastil/tailwind-merge) — Intelligent Tailwind class merging\n- [**Lucide React**](https://lucide.dev/) — Beautiful \u0026 consistent icon library\n- [**Lottie React**](https://github.com/Gamote/lottie-react) — Smooth animations\n\n### **AI \u0026 Voice Technology**\n\n- [**Vapi AI 2.3.10**](https://vapi.ai/) — Real-time voice AI platform\n- [**OpenAI GPT-4**](https://openai.com/) — Advanced language model for tutoring\n- [**ElevenLabs**](https://elevenlabs.io/) — High-quality voice synthesis\n- [**Deepgram Nova-3**](https://deepgram.com/) — Advanced speech-to-text transcription\n\n### **Backend \u0026 Database**\n\n- [**Supabase 2.57.4**](https://supabase.io/) — PostgreSQL database with real-time features\n- [**Clerk 6.31.10**](https://clerk.com/) — Authentication and user management\n- [**Svix 1.76.1**](https://svix.com/) — Webhook management and delivery\n\n### **Form Handling \u0026 Validation**\n\n- [**React Hook Form 7.62.0**](https://react-hook-form.com/) — Performant forms with minimal re-renders\n- [**Zod 4.1.5**](https://zod.dev/) — TypeScript-first schema validation\n- [**Hookform Resolvers 5.2.1**](https://github.com/react-hook-form/resolvers) — Form validation integration\n\n### **Monitoring \u0026 Analytics**\n\n- [**Sentry 10.11.0**](https://sentry.io/) — Error tracking and performance monitoring\n- [**Vercel Speed Insights**](https://vercel.com/docs/speed-insights) — Real-time performance monitoring and Core Web Vitals tracking\n\n### **Development \u0026 Build Tools**\n\n- [**Turbopack**](https://turbo.build/pack) — Fast bundler for development and production\n- [**ESLint 9**](https://eslint.org/) — Code linting and quality assurance\n- [**PostCSS 4**](https://postcss.org/) — CSS post-processing\n\n### **Web Technologies**\n\n- [**JavaScript ES2020+**](https://developer.mozilla.org/en-US/docs/Web/JavaScript) — Modern programming language\n- [**HTML5**](https://developer.mozilla.org/en-US/docs/Web/HTML) — Semantic markup\n- [**CSS3**](https://developer.mozilla.org/en-US/docs/Web/CSS) — Advanced styling and animations\n\n### **DevOps \u0026 CI/CD**\n\n- [**GitHub Actions**](https://github.com/features/actions) — Automated CI/CD pipeline with quality checks\n- [**Vercel**](https://vercel.com/) — Serverless deployment platform with automatic deployments\n- [**ESLint \u0026 TypeScript**](https://typescript-eslint.io/) — Automated code quality and type checking\n- [**Dependency Security**](https://github.com/advisories) — Automated vulnerability scanning\n\n---\n\n## 🔄 CI/CD Pipeline\n\n### **🚀 Automated Workflow**\n\nOur CI/CD pipeline ensures **code quality**, **security**, and **reliable deployments**:\n\n#### **Quality Checks** ✅\n\n- **ESLint** — Code style and best practices validation\n- **TypeScript** — Static type checking and compilation\n- **Build Verification** — Ensures production build succeeds\n- **Dependency Audit** — Security vulnerability scanning\n\n#### **Deployment Strategy** 🌐\n\n- **Production** — Automatic deployment to [eduvox-ai.vercel.app](https://eduvox-ai.vercel.app) on `main` branch\n- **Preview** — Automatic preview deployments for pull requests\n- **Rollback** — Instant rollback capability for critical issues\n\n#### **Pipeline Triggers** 🔄\n\n- **Main Branch** → Production deployment with full quality checks\n- **Pull Requests** → Preview deployment with code review\n- **Security** → Automatic dependency updates and vulnerability alerts\n\n#### **Workflow Status** 📊\n\n```yaml\n✅ Code Quality \u0026 Build Check (1m 6s)\n✅ Security \u0026 Dependency Check (34s)\n✅ Deploy to Vercel (1m 58s)\n⏭️ Preview Deployment (PR only)\n```\n\n---\n\n## 🚀 Getting Started\n\n### **Prerequisites**\n\n- Node.js 18+ installed\n- npm or yarn package manager\n- Supabase account and project\n- Clerk account for authentication\n- Vapi AI account for voice features\n\n### **Installation**\n\n1. **Clone the repository**\n\n```bash\ngit clone https://github.com/huzaifa-fullstack/eduvox-ai.git\ncd eduvox-ai\n```\n\n2. **Install dependencies**\n\n```bash\nnpm install\n```\n\n3. **Environment Setup**\n\nCreate a `.env.local` file with the following variables:\n\n```env\n# Clerk Authentication\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key\nCLERK_SECRET_KEY=your_clerk_secret_key\nNEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in\nNEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/\nCLERK_WEBHOOK_SECRET=your_webhook_secret\n\n# Supabase\nNEXT_PUBLIC_SUPABASE_URL=your_supabase_url\nNEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key\nSUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key\n\n# Vapi AI Voice\nNEXT_PUBLIC_VAPI_WEB_TOKEN=your_vapi_token\n\n# Sentry Error Tracking\nSENTRY_AUTH_TOKEN=your_sentry_token\n\n# Newsletter (Optional)\nBUTTONDOWN_API_KEY=your_buttondown_key\n```\n\n4. **Database Setup**\n\nSet up your Supabase database with the following tables:\n\n- `companions` - AI companion configurations\n- `user_lifetime_stats` - User statistics and limits\n- `session_history` - Learning session records\n- `bookmarks` - User bookmarked companions\n\n5. **Start development server**\n\n```bash\nnpm run dev\n```\n\n6. **Open your browser**\n\n```\nhttp://localhost:3000\n```\n\n7. **Build for production**\n\n```bash\nnpm run build\nnpm start\n```\n\n---\n\n## 📸 Screenshots\n\n### 🔐 **Authentication Page**\n\n![Sign In Page](public/screenshots/sign-in.png)\n\n---\n\n### 🏠 **Homepage - Popular Companions**\n\n![Homepage](public/screenshots/home.png)\n\n---\n\n### 🤖 **All Companions Discovery**\n\n![Companions Page](public/screenshots/companions.png)\n\n---\n\n### 📊 **My Learning Journey**\n\n![Learning Journey](public/screenshots/my-journey.png)\n\n---\n\n### 🛠️ **Companion Builder**\n\n![Companion Creation](public/screenshots/companion-builder.png)\n\n---\n\n### 🎓 **Voice Learning Session**\n\n![Learning Session](public/screenshots/session.png)\n\n---\n\n### 💳 **Subscription Plans**\n\n![Subscription Page](public/screenshots/subscription-plans.png)\n\n---\n\n### 🔖 **Payment Gateway**\n\n![Payment Gateway](public/screenshots/payment.png)\n\n---\n\n### 📈 **Companion Limit**\n\n![Companion Limit](public/screenshots/companion-limit.png)\n\n---\n\n### 📅 **Monthly Limit**\n\n![Monthly Limit](public/screenshots/monthly-limit.png)\n\n---\n\n## 🎥 Preview\n\n![Preview GIF](public/gif/preview.gif)\n\n---\n\n## 🗄️ Database Schema\n\n### **Companions Table**\n\n```sql\n- id (uuid, primary key)\n- name (text) - Companion name\n- subject (text) - Academic subject\n- topic (text) - Specific learning topic\n- voice (text) - Voice type (male/female)\n- style (text) - Teaching style (casual/formal)\n- duration (integer) - Session duration in minutes\n- author (text) - Creator user ID\n- created_at (timestamp)\n```\n\n### **User Lifetime Stats Table**\n\n```sql\n- user_id (text, primary key)\n- conversations_count (integer) - Monthly conversation count\n- created_at (timestamp)\n- updated_at (timestamp)\n```\n\n### **Session History Table**\n\n```sql\n- id (uuid, primary key)\n- user_id (text) - User identifier\n- companion_id (uuid) - Companion reference\n- created_at (timestamp)\n```\n\n### **Bookmarks Table**\n\n```sql\n- id (uuid, primary key)\n- user_id (text) - User identifier\n- companion_id (uuid) - Bookmarked companion\n- created_at (timestamp)\n```\n\n---\n\n## 🎨 Design System\n\n### **Color Palette**\n\n- **Science:** `#E5D0FF` (Purple tint)\n- **Mathematics:** `#FFDA6E` (Golden yellow)\n- **Language:** `#BDE7FF` (Sky blue)\n- **Coding:** `#FFC8E4` (Pink tint)\n- **History:** `#FFECC8` (Warm amber)\n- **Economics:** `#C8FFDF` (Mint green)\n\n### **Component Architecture**\n\n- **Atomic Components** - Reusable UI elements\n- **Compound Components** - Complex interactive features\n- **Layout Components** - Page structure and navigation\n- **Form Components** - Input validation and submission\n\n### **Voice Configuration**\n\n```typescript\nvoices = {\n  male: {\n    casual: \"2BJW5coyhAzSr8STdHbE\",\n    formal: \"c6SfcYrb2t09NHXiT80T\",\n  },\n  female: {\n    casual: \"ZIlrSGI4jZqobxRKprJz\",\n    formal: \"sarah\",\n  },\n};\n```\n\n---\n\n## 🔒 Security \u0026 Privacy\n\n### **Authentication Security**\n\n- **OAuth Integration** with Clerk\n- **Session Management** with automatic token refresh\n- **Route Protection** for authenticated areas\n- **Role-based Access Control**\n\n### **Data Protection**\n\n- **GDPR Compliant** user data handling\n- **Automatic Data Cleanup** on account deletion\n- **Webhook Security** with signature verification\n- **Environment Variable Protection**\n\n### **Content Safety**\n\n- **Input Validation** with Zod schemas\n- **Content Filtering** for inappropriate material\n- **Topic Relevance Validation**\n- **XSS Protection** with TypeScript\n\n### **Error Handling**\n\n- **Graceful Error Recovery**\n- **User-friendly Error Messages**\n- **Comprehensive Logging** with Sentry\n- **Webhook Failure Handling**\n\n---\n\n## 📈 Performance Optimizations\n\n### **Frontend Performance**\n\n- **React 19 Concurrent Features** for smooth UI\n- **Next.js App Router** with optimized routing\n- **Turbopack** for fast development builds\n- **Code Splitting** at route level\n- **Image Optimization** with Next.js Image\n\n### **Voice AI Optimization**\n\n- **Streaming Audio** for real-time conversation\n- **Voice Synthesis Caching**\n- **Efficient Transcription** with Deepgram Nova-3\n- **WebRTC** for low-latency communication\n\n### **Database Performance**\n\n- **Supabase Edge Functions** for server-side logic\n- **Real-time Subscriptions** for live updates\n- **Efficient Query Patterns**\n- **Connection Pooling**\n\n---\n\n## 🔄 Deployment \u0026 DevOps\n\n### **Build Commands**\n\n```bash\nnpm run dev          # Development with Turbopack\nnpm run build        # Production build with Turbopack\nnpm run start        # Production server\nnpm run lint         # Code quality check\n```\n\n### **Deployment Platforms**\n\n- **Vercel** (Recommended) - Optimized for Next.js\n- **Netlify** - Static site deployment\n- **Railway** - Full-stack deployment\n- **Self-hosted** - Docker container ready\n\n### **Environment Configuration**\n\n- **Development** - Hot reload with Turbopack\n- **Staging** - Preview deployments\n- **Production** - Optimized builds\n\n---\n\n## 🎯 AI Assistant Configuration\n\n### **OpenAI GPT-4 Setup**\n\n```typescript\nmodel: {\n  provider: \"openai\",\n  model: \"gpt-4\",\n  messages: [\n    {\n      role: \"system\",\n      content: `You are a highly knowledgeable tutor teaching a real-time voice session with a student. Your goal is to teach the student about the topic and subject.\n\n      Tutor Guidelines:\n      - Stick to the given topic and subject\n      - Keep conversation flowing smoothly\n      - Check student understanding regularly\n      - Break down complex topics into smaller parts\n      - Keep responses short for voice conversation\n      - No special characters in responses`\n    }\n  ]\n}\n```\n\n### **Voice Configuration**\n\n```typescript\nvoice: {\n  provider: \"11labs\",\n  voiceId: selectedVoiceId,\n  stability: 0.5,\n  similarityBoost: 0.75,\n  useSpeakerBoost: true\n}\n```\n\n### **Transcription Setup**\n\n```typescript\ntranscriber: {\n  provider: \"deepgram\",\n  model: \"nova-3\",\n  language: \"en\"\n}\n```\n\n---\n\n## 🚧 Future Enhancements\n\n- [ ] **Multi-language Support** - International education\n- [ ] **Advanced Analytics** - Learning progress tracking\n- [ ] **Collaborative Learning** - Group study sessions\n- [ ] **Mobile App** - iOS and Android applications\n- [ ] **Offline Mode** - Downloaded content access\n- [ ] **Integration APIs** - LMS and school platforms\n- [ ] **Advanced AI Models** - Subject-specific fine-tuning\n- [ ] **Gamification** - Points, badges, and leaderboards\n- [ ] **Parent Dashboard** - Progress monitoring for parents\n- [ ] **Teacher Tools** - Classroom management features\n\n---\n\n## 📊 Project Metrics\n\n### **Codebase Statistics**\n\n- **Components:** 25+ React components\n- **Routes:** 12 application routes\n- **API Endpoints:** 8 serverless functions\n- **Database Tables:** 4 core tables\n- **Types:** 30+ TypeScript interfaces\n- **Lines of Code:** 5,000+ (excluding node_modules)\n\n### **Key Features Count**\n\n- **6 Educational Subjects** supported\n- **4 Voice Options** (Male/Female × Casual/Formal)\n- **Real-time Voice Processing**\n- **Secure Authentication System**\n- **Comprehensive Form Validation**\n- **Responsive Design System**\n- **Error Tracking \u0026 Monitoring**\n- **Webhook Integration**\n\n---\n\n## 🎓 Educational Impact\n\n### **Learning Benefits**\n\n- **Interactive Voice Learning** - More engaging than text\n- **Personalized Tutoring** - AI adapts to student needs\n- **Accessible Education** - Voice-based learning for all\n- **Flexible Scheduling** - Learn anytime, anywhere\n- **Progress Tracking** - Monitor learning journey\n\n### **Academic Subjects Coverage**\n\n- **STEM Education** - Math, Science, Coding\n- **Humanities** - Language, History\n- **Social Sciences** - Economics\n- **Skill Development** - Critical thinking, problem-solving\n\n---\n\n## 🛠️ Development Journey\n\n### **Problem Identification**\n\nTraditional online learning lacks the personal touch and real-time interaction that makes education engaging. EduVox AI bridges this gap by providing AI-powered voice tutors that can adapt to individual learning styles and provide immediate feedback.\n\n### **Solution Architecture**\n\n- **Modern web technologies** for seamless user experience\n- **Advanced AI integration** for intelligent tutoring\n- **Scalable cloud infrastructure** for global accessibility\n- **Security-first approach** for student data protection\n\n### **Technical Challenges Solved**\n\n- **Real-time voice processing** with minimal latency\n- **Intelligent topic validation** to ensure educational relevance\n- **Scalable user management** with conversation limits\n- **Secure webhook handling** for data cleanup\n- **Responsive design** across all device types\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n### **Development Workflow**\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to the branch\n5. Open a Pull Request\n\n### **Code Standards**\n\n- **TypeScript** for type safety\n- **ESLint** for code quality\n- **Prettier** for code formatting\n- **Conventional Commits** for clear history\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## ✍️ Author\n\n**Muhammad Huzaifa Karim**  \n[GitHub Profile](https://github.com/huzaifakarim1)\n\n---\n\n## 🙏 Acknowledgments\n\n- **OpenAI** for GPT-4 language model\n- **ElevenLabs** for voice synthesis technology\n- **Deepgram** for speech recognition\n- **Vapi AI** for voice AI platform\n- **Supabase** for backend infrastructure\n- **Clerk** for authentication services\n- **Vercel** for deployment platform\n\n---\n\n## 📬 Contact\n\nFor questions, feedback, or support:\n\n- Open an issue on GitHub\n- Email: karimhuzaifa590@gmail.com\n\n---\n\n## 🌟 Show Your Support\n\nIf you found this project helpful, please consider:\n\n- ⭐ Starring the repository\n- 🐛 Reporting bugs\n- 💡 Suggesting new features\n- 📢 Sharing with others\n\n---\n\n© 2025 Muhammad Huzaifa Karim\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuzaifa-fullstack%2Feduvox-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuzaifa-fullstack%2Feduvox-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuzaifa-fullstack%2Feduvox-ai/lists"}