SAWWAH is a comprehensive digital tourism platform that redefines how visitors explore Saudi Arabia.
It combines modern technology with authentic Saudi heritage to provide a seamless and engaging tourism experience aligned with Vision 2030.

SAWWAH allows users to explore cities, cultural figures, and national projects across the Kingdom of Saudi Arabia.
The platform highlights the beauty, diversity, and history of the Kingdom while leveraging modern web technologies to present data interactively and intuitively.

• +150 Tourist Destinations
• +100 Notable Figures
• 5 Major Tourist Cities
• +30 Vision 2030 Projects
• Lavender Theme — Inspired by Saudi Arabia’s official color for welcoming guests, representing elegance and harmony with the desert landscape.

1. Enhance Saudi Tourism
   Build a modern digital platform that merges innovation and culture to serve both visitors and investors.

2. Improve Visitor Experience
   Provide detailed and organized information about destinations, figures, and national initiatives.

3. Support Vision 2030
   Contribute to Saudi Arabia’s vision of becoming a leading global tourism destination.

• Interactive exploration of tourism destinations by city
• Profiles of historical and cultural figures
• Overview of Vision 2030 projects
• Fully responsive Flask-based web interface
• Clean and elegant UI with lavender accents

SAWWAH/
├── data/
│ ├── raw/
│ │ ├── English_Characters.xlsx
│ │ ├── English_Cities.xlsx
│ │ └── English_Projects.csv
│ └── cleaned/
│ ├── English_Characters_Cleaned.xlsx
│ ├── English_Cities_Cleaned.xlsx
│ └── English_Projects_Cleaned.xlsx
├── notebooks/
│ ├── Data_Cleaning_and_Preprocessing.ipynb
│ ├── RAG_Evaluation.ipynb
│ ├── RAG_Speech.ipynb
│ ├── Sawwah_Dashboard.ipynb
│ └── Sawwah_EDA.ipynb
├── report/
│ └── Sawwah_final_report.pdf
├── results/
│ ├── Human Evaluation.xlsx
│ ├── rag_evaluation_results_relevant_and_accuracy.xlsx
│ └── rag_evaluation_results.csv
├── web_app/
│ ├── app.py
│ ├── requirements.txt
│ ├── static/
│ │ ├── css/
│ │ │ └── style.css
│ │ ├── js/
│ │ │ └── script.js
│ │ └── images/
│ │ ├── bg.jpg
│ │ └── sawwah_logo.png
│ └── templates/
│ ├── about.html
│ ├── base.html
│ ├── camera.html
│ ├── data.html
│ ├── project.html
│ └── why.html
└── README.md

📁 Folder summary

• data/: raw source files and cleaned datasets used by the app and notebooks.
• notebooks/: Jupyter notebooks for preprocessing, RAG experiments, dashboard work, and EDA.
• report/: final project report.
• results/: evaluation outputs and spreadsheets.
• web_app/: Flask application, static assets, and templates.
• README.md: project documentation.

The platform utilizes three structured datasets stored as CSV/Excel files:

All datasets were cleaned and processed in Python to ensure accuracy, consistency, and readability.

🎬 Watch Demo: YouTube Video

This project was collaboratively developed by a dedicated team of engineers and researchers:

• Areen Alyahya (@chrollolucifr)
• Mudhawi Alshiha (@Mudhawish)
• Nouf Almutairi (@itsnouf)
• Shams Alarifi ()
• Wajd Alrabiah (@WajdAlrabiah)

The visual identity of SAWWAH is inspired by the color Lavender, officially adopted by the Kingdom of Saudi Arabia to welcome guests.
Lavender symbolizes beauty, hospitality, and harmony with the desert, perfectly reflecting SAWWAH’s vision of connecting authentic Saudi culture with modern digital experiences.

Prerequisites:

• Python 3.10+
• Git installed on your system

git clone https://github.com/chrollolucifr/Sawwah.git
cd Sawwah

For macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate

For Windows (PowerShell):

python -m venv .venv
.\.venv\Scripts\Activate.ps1

pip install --upgrade pip
pip install -r web_app/requirements.txt

Ensure the following cleaned datasets are available in the project directory:

• data/cleaned/English_Cities_Cleaned.xlsx
• data/cleaned/English_Characters_Cleaned.xlsx
• data/cleaned/English_Projects_Cleaned.xlsx

If missing, regenerate them by running the data-cleaning notebook:

jupyter notebook notebooks/Data_Cleaning_and_Preprocessing.ipynb
# then run the notebook cells to produce the cleaned files

python web_app/app.py

Once the server starts, open your browser and visit: http://127.0.0.1:5000

To explore data preprocessing or perform exploratory data analysis (EDA):

pip install notebook
jupyter notebook

Then open:

• notebooks/Data_Cleaning_and_Preprocessing.ipynb
• notebooks/Sawwah_EDA.ipynb

• Change port: edit web_app/app.py:

app.run(host="0.0.0.0", port=5000, debug=True)

• Modify dataset paths: if datasets are renamed or moved, update their paths inside app.py.

Your SAWWAH app is now ready to explore! Run the Flask app, open your browser, and enjoy discovering Saudi Arabia digitally 🌸