Omnamdev02 commited on
Commit
cd86c9b
Β·
unverified Β·
1 Parent(s): 9bbfe1f

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +35 -13
README.md CHANGED
@@ -1,6 +1,7 @@
1
- # Exam Question Generator
2
 
3
- An intelligent Python-based system that automatically generates exam questions from input text using NLP techniques.
 
4
 
5
  ## Features
6
 
@@ -8,6 +9,8 @@ An intelligent Python-based system that automatically generates exam questions f
8
  - **Keyword Extraction**: Identifies important concepts using RAKE algorithm
9
  - **Question Generation**: Uses HuggingFace T5 model to generate questions
10
  - **Option Generation**: Creates multiple-choice options with distractors
 
 
11
  - **Multiple Interfaces**: CLI and Web interface (Flask) support
12
  - **JSON Output**: Structured output format for easy integration
13
 
@@ -19,15 +22,15 @@ An intelligent Python-based system that automatically generates exam questions f
19
  pip install -r requirements.txt
20
  ```
21
 
22
- 3. Download required NLTK data:
23
- ```python
24
- python -c "import nltk; nltk.download('punkt'); nltk.download('stopwords'); nltk.download('wordnet')"
25
- ```
26
 
27
  ## Usage
28
 
29
  ### Web Interface
30
- ```bash
 
31
  python app.py
32
  ```
33
  Then open http://localhost:5000 in your browser.
@@ -42,9 +45,28 @@ questions = generator.generate_questions("Your input text here")
42
 
43
  ## Project Structure
44
 
45
- - `question_generator.py` - Core question generation logic
46
- - `text_processor.py` - Text cleaning and preprocessing
47
- - `keyword_extractor.py` - Keyword and important sentence extraction
48
- - `option_generator.py` - Multiple choice option generation
49
- - `app.py` - Flask web application
50
- - `
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # AutoExamGen – AI Based Exam Question Generator
2
 
3
+ AutoExamGen is an intelligent Python-based system that automatically generates exam questions
4
+ (MCQ, short answer, and long answer) from input text using Natural Language Processing (NLP) techniques.
5
 
6
  ## Features
7
 
 
9
  - **Keyword Extraction**: Identifies important concepts using RAKE algorithm
10
  - **Question Generation**: Uses HuggingFace T5 model to generate questions
11
  - **Option Generation**: Creates multiple-choice options with distractors
12
+ - **Syllabus-Based Generation**: Generate questions topic-wise from syllabus input
13
+ - **Download Support**: Export generated question papers
14
  - **Multiple Interfaces**: CLI and Web interface (Flask) support
15
  - **JSON Output**: Structured output format for easy integration
16
 
 
22
  pip install -r requirements.txt
23
  ```
24
 
25
+ 3. Download required NLTK data (run once):
26
+ ```bash
27
+ python setup_nltk.py
 
28
 
29
  ## Usage
30
 
31
  ### Web Interface
32
+ The web interface allows users to upload text or documents and configure question types and difficulty.
33
+
34
  python app.py
35
  ```
36
  Then open http://localhost:5000 in your browser.
 
45
 
46
  ## Project Structure
47
 
48
+ - `app.py` – Flask web application (main entry point)
49
+ - `exam_question_system.py` – Orchestrates the complete question generation pipeline
50
+ - `question_generator.py` – Core question generation logic
51
+ - `text_processor.py` – Text cleaning and preprocessing
52
+ - `keyword_extractor.py` – Keyword and concept extraction (RAKE)
53
+ - `option_generator.py` – MCQ option and distractor generation
54
+ - `syllabus_processor.py` – Syllabus-based question generation
55
+ - `local_question_generator.py` – Transformer-based (T5) question generator
56
+ - `setup_nltk.py` – NLTK data setup script
57
+
58
+ ## Technologies Used
59
+
60
+ - Python
61
+ - Flask
62
+ - Natural Language Processing (NLP)
63
+ - NLTK
64
+ - RAKE Algorithm
65
+ - HuggingFace Transformers (T5)
66
+ - HTML, CSS (Web Interface)
67
+ ## Author
68
+
69
+
70
+ **Om Namdev**
71
+ B.Tech AI & DS
72
+ Aspiring Data Scientist