Full Stack Real-time Teaching Platform with AI

📋 Table of Contents

1. 🌟 Introduction
2. ⚙️ Tech Stack
3. 📝 Features
4. 🚀 Quick Start

🌟 Introduction

[EN] Converso is an AI-powered learning app built with Next.js, Vapi, and Clerk. It enables users to create custom, voice-driven courses (“Companions”), participate in real-time conversational lessons with smooth, low-latency voice powered by Vapi, and easily manage authentication and billing through a secure subscription system powered by Clerk.

[FR] Converso est une application d’apprentissage intelligente propulsée par l’IA, développée avec Next.js, Vapi et Clerk. Elle permet aux utilisateurs de créer des cours sur mesure, animés par la voix (« Companions »), de suivre des leçons conversationnelles en temps réel avec une voix fluide et à faible latence grâce à Vapi, et de gérer simplement l’authentification et la facturation via un système d’abonnement sécurisé assuré par Clerk.

⚙️ Tech Stack

• Clerk is a unified platform for authentication, user management, and billing. It offers embeddable UI components, flexible APIs, and admin dashboards for secure user management. Clerk also simplifies subscription management, allowing you to define plans, create pricing pages, and control access based on subscription tiers—all in one solution.

• Next.js is a powerful React framework that enables the development of fast, scalable web applications with features like server-side rendering, static site generation, and API routes for building full-stack applications.

• Sentry is an error tracking and performance monitoring tool that helps developers fix bugs faster by providing real-time alerts, stack traces, and performance insights.

• shadcn/ui is a customizable component library built on Radix UI and Tailwind CSS. It offers a modern, accessible design system with pre-built components that are easy to theme and extend, making it ideal for building polished UIs with minimal effort.

• Supabase is an open-source backend-as-a-service platform that provides instant APIs, real-time subscriptions, authentication, storage, and a PostgreSQL database, enabling developers to build scalable and secure applications with ease.

• Tailwind CSS is a utility-first CSS framework that allows developers to design custom user interfaces by applying low-level utility classes directly in HTML, streamlining the design process.

• TypeScript is a superset of JavaScript that adds static typing, providing better tooling, code quality, and error detection for developers, making it ideal for building large-scale applications.

• Vapi is a developer-centric voice AI platform that enables the creation of conversational voice agents with low-latency voice interactions, speech-to-text, and text-to-speech capabilities. It supports multilingual conversations, customizable voices, and seamless integration with various AI models and tools.

📝 Features

👉 AI Voice Agents: Take tutoring sessions with voiced AIs specializing in the topics you want to get better at.

👉 Authentication: Secure user sign-up and sign-in with Clerk; Google authentication and many more.

👉 Billing & Subscriptions: Easily manage plans, upgrades, and payment details.

👉 Bookmarks and Session History: Let users organise their learning by bookmarking tutors and accessing previous sessions.

👉 Code Reusability: Leverage reusable components and a modular codebase for efficient development.

👉 Create a Tutor: Create your own AI tutors, choosing a subject, topic, and style of conversation.

👉 Cross-Device Compatibility: Fully responsive design that works seamlessly across all devices.

👉 Database Integration: Uses Supabase for real-time data handling and storage needs.

👉 Modern UI/UX: Clean, responsive design built with Tailwind CSS and shadcn/ui for a sleek user experience.

👉 Scalable Tech Stack: Built with Next.js for a fast, production-ready web application that scales seamlessly.

👉 Search Functionality: Find tutors quickly with robust filters and search bar.

And many more, including code architecture and reusability.

🚀 Quick Start

Follow these steps to set up the project locally on your machine.

Prerequisites

Make sure you have the following installed on your machine:

• Git
• Node.js
• npm (Node Package Manager)

Cloning the Repository

git clone {remote URL}

Installation

Install the project dependencies using npm:

npm install

Set Up Environment Variables

Create a new file named .env in the root of your project and add the following content:

# Sentry
SENTRY_AUTH_TOKEN=

# Vapi
NEXT_PUBLIC_VAPI_WEB_TOKEN=

# Clerk
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/
NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/

# Supabase
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=

Replace the placeholder values with your actual ImageKit, NeonDB, Upstash, and Resend credentials. You can obtain these credentials by signing up on: Appwrite, Clerk, Sentry, Vapi.

Running the Project

npm run dev

Open http://localhost:3000 in your browser to view the project.