تفاصيل العمل

### Personal AI Assistant

A full-stack **AI-powered study assistant** designed to provide students with an interactive learning experience through text and voice. The system, **Rabab**, combines conversational AI, RAG-based material search, automated quiz generation, voice interaction, and Google Calendar integration in a single web application.

### Key Features

* **AI Study Assistant:** Answers students' questions based on uploaded educational materials.

* **RAG & Material Management:** Supports PDF, DOCX, TXT, MD, and CSV files, with indexing for intelligent retrieval.

* **Voice Interaction:** Enables students to communicate naturally using Speech-to-Text and Text-to-Speech through the browser.

* **Quiz Generation:** Automatically generates quizzes from study materials.

* **Google Calendar Integration:** Allows administrators to schedule and delete meetings with automatically generated Google Meet links.

* **Chat History:** Saves up to 50 conversations per user and allows students to resume previous sessions.

* **Role-Based Access Control:** Separate permissions and functionality for students and administrators.

* **Material Viewer:** Allows students to read uploaded study materials directly inside the application.

### Technical Implementation

The application was built using **React, TypeScript, Tailwind CSS, and shadcn/ui** on the frontend, with a **Python FastAPI and SQLite** backend. AI capabilities are powered by the **Groq API**, while voice interaction uses the browser's **Web Speech API**. Google Calendar API is integrated for meeting scheduling and Google Meet generation.

### AI & Voice Engineering

The voice agent includes custom processing for wake-word detection, Levenshtein-based name matching, speech normalization, gibberish filtering, and response cleaning before Text-to-Speech generation. This allows users to interact with Rabab naturally despite common speech-recognition errors.

### Project Highlights

* Full-stack AI application architecture

* RAG-based educational assistant

* Voice-enabled conversational AI

* Automated quiz generation

* Google Calendar & Google Meet integration

* Role-based authentication and authorization

* Document ingestion and indexing

* Responsive modern UI

* RESTful API architecture

**Technologies:** Python, FastAPI, React, TypeScript, Tailwind CSS, SQLite, Groq API, LLaMA, RAG, Web Speech API, Google Calendar API, Google Meet, Vite.