Skip to content

Repository files navigation

ALIA (Advanced Lecture Interactive Assistant)

ALIA Banner

Transform your audio lectures into a searchable, interactive knowledge base. ALIA leverages state-of-the-art AI to provide transcripts, summaries, and study questions, helping you learn and recall information faster and more effectively.


🚀 Live Demo

Experience the live application deployed on Vercel:

https://alia01.vercel.app/


✨ Key Features

ALIA is packed with features designed for a seamless and powerful user experience:

  • 🧠 AI-Powered Analysis: Integrates AssemblyAI for transcription and Google Gemini for intelligent summaries, titles, and question generation.
  • 👤 Secure User Accounts: Full authentication system using NextAuth.js with Google as an OAuth provider.
  • 🕵️ Guest Mode: Try out the full analysis pipeline without signing up. Your session history is stored locally and automatically cleared after 24 hours.
  • 🗂️ Persistent, User-Specific History: Logged-in users have their entire analysis history saved securely to their account.
  • 🔍 Semantic Search: A powerful search engine that understands concepts, not just keywords. Find relevant analyses by searching for topics and ideas.
  • ✍️ History Management: Easily rename your analyses for better organization or delete them when they are no longer needed.
  • 🔗 Shareable Reports: Generate a unique, public link for any analysis to share your findings with colleagues, classmates, or friends.
  • 🎨 Sleek Dark Theme: A polished, professional, and comfortable dark theme inspired by modern developer tools.
  • 🔒 Full Data Control: A comprehensive settings page allows you to manage your profile, delete your entire history, or permanently delete your account and all associated data.

screenshots

Homepage (Guest View) Analysis Results Page
Homepage Analysis Results

🛠️ Tech Stack

This project was built with a modern, robust, and scalable tech stack:

Category Technology
Framework Next.js (App Router)
Frontend React, Tailwind CSS
UI Primitives Radix UI (for the dropdown menu)
Authentication Auth.js (NextAuth.js)
Backend Next.js API Routes (Serverless Functions)
Database MongoDB Atlas (with Mongoose)
AI Services AssemblyAI (Transcription), Google Gemini (LLM/Embeddings)
Deployment Vercel

🔧 Getting Started (Local Development)

Want to run your own instance of ALIA? Follow these steps.

Prerequisites

1. Clone the Repository

git clone https://github.com/Terra-01/ALIA.git
cd alia-nextjs

2. Install Dependencies

npm install

3. Set Up Environment Variables

Create a file named .env.local in the root of the project and add the following variables.

# MongoDB Connection String (from your Atlas cluster)
MONGO_URI="your_mongodb_connection_string"

# AI Service API Keys
ASSEMBLYAI_API_KEY="your_assemblyai_api_key"
GEMINI_API_KEY="your_google_gemini_api_key"

# Auth.js Secrets
# Generate a strong secret with: `openssl rand -base64 32` in your terminal
AUTH_SECRET="your_super_secret_auth_secret_here"
AUTH_GOOGLE_ID="your_google_oauth_client_id"
AUTH_GOOGLE_SECRET="your_google_oauth_client_secret"

# App URL (for development)
NEXT_PUBLIC_APP_URL="http://localhost:3000"

4. Configure Google OAuth Redirect URI

In your Google Cloud Console, ensure your OAuth client ID has the following authorized redirect URI for local development:

  • http://localhost:3000/api/auth/callback/google

5. Run the Development Server

npm run dev

The application should now be running at http://localhost:3000.


🚀 Deployment

This application is optimized for deployment on Vercel. To deploy your own instance, simply import your forked repository into Vercel and configure the same environment variables in the project settings.

Remember to update NEXT_PUBLIC_APP_URL and the Google OAuth Redirect URI to match your production domain.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

About

Advanced Lecture Interactive Assistant

Resources

Stars

1 star

Watchers

1 watching

Forks

Contributors

Languages