Skip to content

Anagha-S-K/Cleverly-AI-Powered-Learning-Assistant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cleverly – AI-Powered Learning Assistant

Cleverly is an intelligent web application that transforms PDF textbooks and study materials into interactive learning content using advanced large language models.
Upload any PDF and Cleverly will automatically generate clear summaries, flashcards, and quiz questions tailored to the material—making studying easier, faster, and more engaging.


✨ Features

  1. Automatic Summarization Get concise, multi-paragraph summaries from your study materials.

  2. Flashcard Generation
    Instantly convert textbook content into flashcards for active recall and spaced repetition.

  3. Quiz Creation Practice understanding with autogenerated quiz questions based on your uploaded PDFs.

  4. Modern Web Interface
    User-friendly React frontend with seamless file upload and results navigation.

  5. Powered by State-of-the-Art AI
    Utilizes Meta Llama-3.1 8B Instruct via the OpenRouter API for fast, accurate, and context-aware educational content.


🚀 Tech Stack

  1. Frontend: React.js, CSS
  2. Backend: Python
  3. AI Model: Meta Llama-3.1 8B Instruct (OpenRouter API)
  4. File Handling: PDF processing and parsing

📂 How It Works

  1. Upload a PDF – Drag and drop your study material or select from your files.
  2. AI Processing – Cleverly analyzes the content using LLMs.
  3. Get Results – View summaries, flashcards, and quizzes instantly.
  4. Study Smarter – Use the interactive tools for better retention.

👥 Contributors

  1. Anagha S K - https://github.com/Anagha-S-K
  2. Gowtham N Rao - https://github.com/Gomaa03

🛠 Installation & Setup

# Clone the repository
git clone https://github.com/Anagha-S-K/cleverly.git
cd cleverly/backend

# Navigate to project folder
cd cleverly

# Create Virtual Environment and Install dependencies
python -m venv venv
source venv/bin/activate  # For Mac/Linux
venv\Scripts\activate     # For Windows
pip install -r requirements.txt

#Set your API Key
export OPENROUTER_API_KEY=your_openrouter_api_key_here  # Mac/Linux
set OPENROUTER_API_KEY=your_openrouter_api_key_here     # Windows

# Run Backend Server
python app.py

#Navigate to the frontend directory
cd cleverly/frontend

#Install dependencies
npm install

#Start the development server
npm start

About

Cleverly is an intelligent web app that transforms PDF textbooks and study materials into customized learning content using advanced large language models. Upload any PDF and Cleverly automatically generates clear summaries, interactive flashcards, and quiz questions tailored to the material—making studying easier, faster, and more engaging.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors