Dhakirate-Al-Djazair: Reviving Algerian History Education with Large Language Models and Retrieval-Augmented Generation
# Dhakirate-Al-Djazair: Reviving Algerian History Education with Large Language Models and Retrieval-Augmented Generation
## Project Overview
Dhakirate-Al-Djazair is an educational platform that leverages state-of-the-art NLP techniques, Retrieval-Augmented Generation, and gamification to enhance the teaching and learning of Algerian history.
## Repository Structure
- **Backend Logic**: Flask application providing API endpoints for the frontend
- **Notebooks and Data**: Educational dataset on Algerian history and analysis notebooks
- **Platform**: React-based frontend for the educational platform
- **Dhakirate-AL-Djazair_Project_Report.pdf**: Comprehensive project documentation
## Installation & Setup
### Frontend (React)
**Note**: The frontend and backend must run together to work properly.
#### Prerequisites
You need to install the latest Node.js and npm:
**On Windows (using Chocolatey):**
```powershell
# Download and install Chocolatey
powershell -c "irm
community.chocolatey.org"
# Download and install Node.js
choco install nodejs-lts --version="23"
# Verify installation
node -v # Should print "v23.6.0"
npm -v # Should print "10.9.2"
```
**On Linux (using NVM):**
```bash
# Download and install nvm
curl -o-
raw.githubusercontent.com | bash
# Close and reopen terminal
# Download and install Node.js
nvm install 23
# Verify installation
node -v # Should print "v23.6.0"
nvm current # Should print "v23.6.0"
npm -v # Should print "10.9.2"
```
#### Setup and Run
```bash
# In the frontend directory
npm install
# If errors occur, try:
npm install --legacy-peer-deps
# or
npm install --force
# Start the application
npm start
# This will run the frontend on localhost:3000
```
### Backend (Flask)
The backend app provides an API for the frontend to consume. It represents the most refined version of the code, with enhancements to the chatbot, RAG implementation, and quiz generation.
**Note**: …