zeyadsheriif/EgyGuide

EgyGuide is a cross platform intelligent agent designed to revolutionize the way tourists interact with historical and cultural landmarks in Egypt. By leveraging Deep Learning and LLMs, EgyGuide transforms a smartphone into a knowledgeable, virtual human like guide. # EgyGuide: AI-Powered Intelligent Tourist Guide EgyGuide is a full-stack graduation project that identifies selected Egyptian landmarks from images and provides retrieval-grounded conversational explanations. ## Project Overview EgyGuide addresses a common problem in cultural tourism and heritage education: visitors often see a monument, statue, temple, or artifact without knowing its name, dynasty, location, or historical context. Static signs, guidebooks, and general search engines usually require the visitor to know what to search for, while human guides may not always be available, affordable, or multilingual. The project implements an AI-assisted web application for tourists, students, museum visitors, and heritage learners. Users can upload, drag and drop, or capture an image through the browser camera. The backend classifies the image into one of the implemented Egyptian heritage classes, returns structured metadata and a confidence score, and enables follow-up questions through an artifact-specific chat. A separate general chat page supports broader Egyptian heritage questions. The implemented system combines an Angular 19 single-page frontend with a Flask backend. The backend uses TensorFlow/Keras image classification, a 12,670-row text corpus, SentenceTransformers embeddings, FAISS retrieval, Qwen2.5-1.5B-Instruct answer generation, Arabic translation support, and SQLite chat logging. The repository is intended as a reproducible academic MVP and a foundation for future production hardening. ## Team Information **Team Number:** 37 ## Team Members | Name | Student ID | Program | |---|---:|---| | Zeyad Sherif | 202201220 | DSAI | | Sama Mohamed | 202201867 | DSAI | | Salma Wael | 202201761 | DSAI | | Dana Amr | 202201323 | DSAI | ## Supervisor Dr. Mohamed Maher Ata ## Problem Statement Visitors to Egyptian heritage sites and museums often lack immediate, accurate, and interactive access to information about the objects they encounter. The proble …