Skip to content

mizazhaider-ceh/Study-Copilot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔥 Study Copilot v2.1

Study Copilot Banner JavaScript Tailwind AI Powered License

Typing SVG

🧠 The Context-Aware AI Tutor

Professional-grade educational platform blending advanced AI with a distraction-free glassmorphism UI.

Created with ❤️ by Muhammad Izaz Haider

🚀 Quick Start✨ Features📸 Screenshots🔧 Installation👤 About Me


Stars Forks Issues


🎯 What is Study Copilot?

Study Copilot is an all-in-one intelligent study environment designed to replace the fragmented stack of tools students use today. It combines a conversational AI tutor, an automated quiz generator, and a smart document analyzer into a single, cohesive, and beautiful web application.

🔥 The Evolution

v1.0 → Basic Chatbot (Gemini Only)
v2.0 → UI Overhaul + Multiple Tools
v2.1 → Multi-Model (Cerebras) + Doc Uploads ← You are here!

💡 Why Study Copilot?

🚀 All-in-One - Chat, Quiz, Summarize in one tab
🧠 Context-Aware - Reads your uploaded PDFs
🎨 Glass UI - Stunning, distraction-free design
Lightning Fast - Powered by Cerebras (~2000 t/s)


🚀 Quick Start

# Clone the repository
git clone https://github.com/mizazhaider-ceh/Study-Copilot.git
cd Study-Copilot

# No npm install needed! (It's Pure JS)

# Launch the app
# Open index.html in your browser
# OR use a local server (Recommended)
npx http-server .

💡 Pro Tip: Use VS Code's "Live Server" extension for the smoothest experience.


📁 Project Structure

Study-Copilot/
├── index.html              # Main Application Entry
├── README.md               # Documentation
├── style.css               # (Deprecated/Merged into Tailwind)
├── js/                     # Core Logic
│   ├── main.js             # App Initialization & Event Wiring
│   ├── config.js           # Constants, Prompts & Branding
│   ├── state.js            # Custom State Management System
│   ├── nav.js              # Navigation Controller
│   ├── features/           # Feature Modules
│   │   ├── chatbot.js      # AI Chat Interface
│   │   ├── tools.js        # Teacher, Quiz, & Summarizer Logic
│   │   ├── history.js      # LocalStorage History Manager
│   │   └── file-utils.js   # PDF/Doc Parsing Utilities
│   ├── services/           # Backend Services
│   │   ├── api.js          # Cerebras & Gemini Integration
│   │   └── storage.js      # Secure Local Persistence
│   └── ui/                 # UI Components
│       ├── dom.js          # DOM Manipulation Helpers
│       ├── modal.js        # Accessible Modal System
│       └── theme.js        # Dynamic Theme Switcher
└── images/                 # Assets (Logos, Icons)

✨ Features

🌐 Modern Web Interface

Glassmorphism Design - Blur-enhanced, premium UI
10+ Dynamic Themes - Midnight, Cyber, Ocean...
Mobile Responsive - Works perfectly on any device
Zero-Lag Input - Optimized for instant interaction
Local Privacy - Keys stored only in your browser

🧠 Dual-Core AI Engine

Cerebras Inference - Llama 3.3 70B @ ~2000 t/s
Google Gemini - 1.5 Flash as powerful fallback
Model Switcher - Toggle between Llama, Qwen, GPT
Context Awareness - Remembers your active topic
Smart Prompts - System-level persona injection


📚 Intelligent Study Modules

Module Description Capability
🤖 AI Chatbot Full conversational tutor 💬 Context-aware Q&A
📝 Question Generator Automated exam creator 📄 PDF/Doc Upload Support
🔍 Doc Q&A Chat with your textbook 🧠 RAG-lite Document Analysis
👨‍🏫 AI Teacher Smart topic explainer 🎓 3 Modes: Simple, Detailed, Analogy
Summarizer Content condenser 📌 Extracts Key Facts & Vocabulary
🗒️ Notes Enhancer Raw note organizer ✏️ Formats & Structures Ideas

📚 Deep Dives & Documentation

Want to understand the "Why" and "How" behind this project? Read our focused reports:

  • 🚀 The Journey & Manifesto: The personal story of why this tool exists, the philosophy behind it, and the full feature breakdown.
  • 📉 Development Impact Report: A detailed technical breakdown of how each phase (Logic, UI, Intelligence) solved specific problems and saved hours of study time.

🔧 Installation

Prerequisites

  • Modern Web Browser (Chrome, Edge, Firefox, Safari)
  • Internet Connection (for AI API access)
  • (Optional) Cerebras or Gemini API Key

Step-by-Step

# 1. Clone repository
git clone https://github.com/mizazhaider-ceh/Study-Copilot.git
cd Study-Copilot

# 2. Open the application
# Simply double-click index.html

🤖 Get Your Free API Key

  1. Cerebras: Go to https://cloud.cerebras.ai/ (Fastest)
  2. Gemini: Go to https://aistudio.google.com/ (Reliable)
  3. Enter key in Settings inside the app.

💡 Why Cerebras? It runs Llama 3.3 70B at speeds that make the AI feel like it's thinking in real-time.


🎯 Usage

Question Generator (with File Upload)

  1. Navigate to Question Generator tab.
  2. Click Upload Document and select your PDF/Word lecture notes.
  3. (Optional) Type a specific topic to focus on.
  4. Click Generate Questions.
  5. Result: The AI reads your specific document and creates a custom test for you.

Chat with Document

  1. Upload your file in the Question Generator.
  2. Scroll down to "Ask Specific Question".
  3. Ask: "What is the main conclusion of this paper?"
  4. Result: Instance answer based only on your file.

AI Teacher

  1. Go to AI Teacher.
  2. Type a topic (e.g., "Quantum Entanglement").
  3. Select Style: Detailed, Simplified, or Analogy.
  4. Result: A perfect explanation tailored to your mental model.

⚙️ Configuration

Model Switcher

You are not stuck with one brain. Go to Settings and choose:

  • Llama 3.3 70B (Recommended: Smart & Fast)
  • Llama 3.1 8B (Ultra-Fast)
  • OpenAI GPT-OSS 120B (Dense Knowledge)
  • Qwen 3 & GLM 4.7 (Cutting-edge Previews)

Custom Themes

Personalize your study space. Choose from: Glass, Light, Midnight, Ocean, Forest, Sunset, Lavender, Nebula, Aurora, Cyber.


🛡️ Privacy & Security

Client-Side Only - No proprietary backend server reading your data.
Local Storage - Your API keys live in your browser's localStorage.
Direct Connection - Requests go straight from your browser to the AI provider.


👤 The Story Behind Study Copilot

🚀 From Frustrated Student to AI Engineer

"Education is not the filling of a pail, but the lighting of a fire."

Study Copilot started as a personal solution to a universal problem: Academic Overwhelm. As a cybersecurity student, I found myself with 50 browser tabs open—one for summarizing, one for quizzing, one for searching—and I realized the tool I needed didn't exist.

I wanted a "Copilot"—someone sitting next to me who had read every book, knew every fact, and could test me on my own notes instantly.

📍 The Journey

Phase What I Built Why
v1.0 Simple Gemini Wrapper Proof of Concept
v2.0 Glassmorphism UI Tools need to be beautiful
v2.1 Context-Aware Engine Generic AI wasn't enough

💡 Philosophy

✅ Synthesis over search
✅ Active recall over passive reading
✅ Deep work over distraction
✅ "If you can't explain it simply, you don't understand it well enough."

👤 Author

Muhammad Izaz Haider

Muhammad Izaz Haider

Junior DevSecOps & AI Security Engineer @ Damno Solutions
Penetration Tester | Cybersecurity Student @ Howest University 🇧🇪
AI Security Researcher | Founder @ The PenTrix


🇵🇰 → 🇧🇪 From a small Pakistani village to the European tech frontier.

Built on coffee, code, and curiosity.


LinkedIn GitHub Email


⭐ Star this repo if it helps you study smarter!

Footer

Made with ❤️ by Muhammad Izaz Haider

"The best way to predict the future is to invent it."


Visitors

About

Intelligent AI Study Environment & Context-Aware Tutor. Featuring ultra-fast Cerebras inference (~2000 t/s), multi-model switching (Llama 3.3/Gemini), and RAG-lite document analysis. A distraction-free, pure JavaScript glassmorphism platform for automated learning.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors