Skip to content

README.md

Latest commit

 

History

History
81 lines (58 loc) · 2.79 KB

README.md

File metadata and controls

81 lines (58 loc) · 2.79 KB

ExamForge 🎓

AI-powered mock exam coach — any certification, any exam.

Works entirely in your browser. No server. No install. Just open index.html.

🎬 Demo

ExamForge Demo

🚀 Quick Start

Option A — Download & run locally:

  1. Download ZIP → Unzip
  2. Open index.html in Chrome or Edge — done!

Option B — Clone:

git clone https://github.com/krishnaramadas/ExamForge.git
cd ExamForge
# Open index.html in your browser

Option C — Open online (no download): 🌐 krishnaramadas.github.io/ExamForge

🤖 AI Provider Setup (First-time)

The 4-step onboarding wizard will guide you through everything:

Step What happens
1️⃣ Connect AI Pick OpenAI or Google Gemini and paste your API key
2️⃣ Choose Exam Select from AWS, GCP, SnowPro, Azure, PMP, CFA, UPSC and more
3️⃣ Study Material Upload notes (PDF/DOCX/TXT) or skip to use AI knowledge
4️⃣ Exam Config Set questions per session, time limit, difficulty

Get an API key:

Your API key is stored only in your browser's local storage. Never sent anywhere except directly to the AI provider.

✨ Features

  • 🎯 Any exam — AWS, GCP, SnowPro, PMP, CFA, Kubernetes, UPSC…
  • 📂 Upload study notes — PDF, DOCX, TXT → AI extracts MCQs
  • ✨ AI Discovery — Generate questions from AI's exam knowledge (no notes needed)
  • ⏱️ Timed mock exams — Custom question count, time limit, difficulty
  • 🧭 Question palette — Jump between questions, track answered/unanswered
  • 🔍 Practice mode — Instant feedback + explanations after each answer
  • 📊 Results & analytics — Score history, topic breakdown, full answer review
  • 💾 Export/import — Save your question bank as JSON and share it
  • 🤖 OpenAI + Gemini — Switch providers any time in Settings

🗂 Project Files

File Purpose
index.html App structure + onboarding
app.js All logic — AI calls, exam engine, storage
style.css Full design system

🌐 Host for Free (GitHub Pages)

  1. Fork this repo
  2. Go to Settings → Pages
  3. Source: Deploy from branch → main → / (root) → Save
  4. App is live at https://YOUR_USERNAME.github.io/ExamForge in ~60 seconds

🔒 Privacy

All data — questions, history, API key — lives in your browser only (localStorage). No account, no backend, no tracking.