Skip to content

KonkurRAG is an AI-powered PhD exam preparation system that uses Retrieval-Augmented Generation to learn from 10+ years of Computer Science exam questions. It delivers targeted explanations, pattern mining, personalized quizzes, and topic recommendations to maximize exam performance.

Notifications You must be signed in to change notification settings

UDynamic/RAG4Konkur

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

KonkurRAG

AI-Powered PhD Exam Preparation Using Retrieval-Augmented Generation

KonkurRAG is an intelligent study assistant designed to help candidates prepare for the Iranian PhD entrance exam in Computer Science (AI). It leverages a RAG pipeline built on 10+ years of historical exam questions to provide precise, exam-aligned learning.


πŸš€ Features

RAG-Based Retrieval

  • Retrieves similar past exam questions
  • Searches by topic, difficulty, or pattern
  • Uses embeddings + reranking for high accuracy

Smart Explanations

  • Generates clear walkthroughs for AI, ML, DSA, math, and reasoning questions
  • Provides step-by-step logic aligned with exam style

Personalized Study Guidance

  • Detects weak topics automatically
  • Recommends what to study next
  • Builds targeted quizzes from real exam data

Pattern Mining

  • Identifies repeated question types
  • Highlights high-yield topics
  • Tracks your progress over time

πŸ› οΈ Architecture

RAG Pipeline: PDF Exams β†’ Text Chunking β†’ Metadata Tagging β†’ Embedding Model (E5/BGE) β†’ Vector Store (Chroma/Weaviate/Qdrant) β†’ Reranker β†’ LLM (GPT / LLaMA) β†’ Query Response Engine


πŸ“ Project Structure

konkurrag/ data/ pdfs/ (Raw exam PDFs) processed/ (Extracted & cleaned text) metadata.json (Tags: year, topic, difficulty)

src/ ingestion/ (PDF parsers, chunkers) embeddings/ (Embedding models & vector store) retriever/ (Similarity search + reranking) generator/ (LLM answer generator) pipeline.py (Full RAG pipeline) api/ (Optional REST API)

notebooks/ exploration.ipynb analysis.ipynb (Pattern mining & topic mapping)

README.md


πŸ“¦ Installation

Run the following:

git clone https://github.com/yourusername/konkurrag cd konkurrag pip install -r requirements.txt


▢️ Usage

Example: Run a query

from konkurrag.pipeline import ask answer = ask("Teach me AVL tree rotations with examples") print(answer)

Example: Retrieve similar past questions

ask("Show me past exam questions about Lagrange multipliers")


🧩 To-Do (Roadmap)

  • Add exam difficulty prediction
  • Add spaced-repetition flashcards
  • Add UI dashboard (Streamlit)
  • Add question auto-classifier
  • Add progress analytics

πŸ† Why KonkurRAG?

Because the best teacher is 10 years of real exam data combined with LLM intelligence.
No randomness. No clutter. Pure exam-focused learning.


πŸ“œ License

MIT License.

About

KonkurRAG is an AI-powered PhD exam preparation system that uses Retrieval-Augmented Generation to learn from 10+ years of Computer Science exam questions. It delivers targeted explanations, pattern mining, personalized quizzes, and topic recommendations to maximize exam performance.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published