Skip to content
View AdhamElsayedAI's full-sized avatar

Block or report AdhamElsayedAI

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
AdhamElsayedAI/README.md
Adham Elsayed Adham Elsayed β€” AI Engineer

Portfolio LinkedIn GitHub RΓ©sumΓ©

Computer Vision Β· Edge AI Β· RAG / LLM Systems Β· Model Evaluation


🧭 About Me

Build the model β†’ measure the behavior β†’ connect the architecture β†’ ship the system.

I'm an AI Engineer focused on turning models into complete, inspectable systems. My work spans computer vision, edge deployment, RAG / LLM engineering, model evaluation, APIs, data pipelines, and intelligent applications.

class AdhamElsayed:
    role = "AI Engineer"
    location = "Egypt"

    focus = [
        "Computer Vision",
        "Edge AI",
        "RAG / LLM Systems",
        "Model Evaluation",
        "Intelligent Applications",
    ]

    systems = {
        "Smart Basket": "edge vision + synchronized retail state",
        "MedFlow": "evidence-grounded RAG + safety validation",
        "Code AI Proctor": "visual inference + auditable exam workflow",
    }

    engineering_loop = "Data β†’ Model β†’ Evaluate β†’ Serve β†’ Product β†’ Iterate"

Featured Systems Β· Core Skills Β· Tech Stack Β· Evidence Β· Contact


πŸ”₯ Featured Systems

πŸ‘οΈ 1. Smart Basket β€” Edge AI Retail System

Real-time retail product recognition running on Raspberry Pi 5, connected to basket-state logic, Firebase synchronization, and a Flutter application.

Repository Smart-Basket
Stack YOLO Β· OpenCV Β· ONNX Runtime Β· Raspberry Pi 5 Β· Firebase Β· Flutter
Capability Edge product detection + stabilized basket state + mobile synchronization
Validation mAP@0.5 = 96.89% Β· mAP@0.5:0.95 = 84.79%

πŸ—οΈ System Architecture

flowchart LR
    CAM[Pi Camera] --> PRE[OpenCV preprocessing]
    PRE --> YOLO[YOLO detector]
    YOLO --> EDGE[ONNX Runtime on Raspberry Pi 5]
    EDGE --> STATE[Basket state tracker]
    STATE -->|state changed| FB[(Firebase)]
    FB --> APP[Flutter application]
    EDGE -. runtime telemetry .-> MON[Runtime monitor]
Loading

Architecture notes

  • Camera frames are prepared before inference with OpenCV.
  • ONNX Runtime moves inference onto Raspberry Pi 5 instead of depending on a cloud model endpoint.
  • Basket-state confirmation / hold behavior reduces unstable product-state changes.
  • Firebase updates are written when state changes rather than continuously rewriting identical state.
  • Flutter consumes the synchronized basket state at the application layer.

Inspect Smart Basket β†’


🩺 2. MedFlow β€” Evidence-Grounded Clinical RAG

A thyroid-focused clinical AI prototype where retrieval, evidence sufficiency, generation, citation resolution, claim validation, numeric safety, and final policy are separate system layers.

Repository Medflow
Stack FastAPI Β· BGE Β· ChromaDB Β· BM25 Β· RRF Β· Groq / GPT-OSS
Capability Evidence-grounded answers with traceable citations and explicit safety routing
Retrieval Precision@4 = 53.12% Β· Hit@4 = 87.50% Β· MRR β‰ˆ 0.7031

πŸ—οΈ Runtime Architecture

flowchart TB
    U[User] --> UI[MedFlow web UI]
    UI --> API[FastAPI backend]
    API --> GUARD[Input guardrail]
    GUARD --> RISK{Risk class}

    RISK -->|refuse / redirect| SAFE[Safe redirect]
    RISK -->|allowed / caution| RET[Retrieval layer]

    subgraph Retrieval
      DENSE[Dense retrieval: BGE + ChromaDB]
      SPARSE[Sparse retrieval: BM25]
      FUSION[Reciprocal Rank Fusion]
      DENSE --> FUSION
      SPARSE --> FUSION
    end

    RET --> DENSE
    RET --> SPARSE
    FUSION --> GATE{Evidence sufficiency gate}
    GATE -->|block| ABSTAIN[Abstain]
    GATE -->|pass / downgrade| PACK[Evidence packaging E1..E4]
    PACK --> LLM[Grounded LLM]

    LLM --> CITE[Citation engine]
    LLM --> CLAIM[Claim validator]
    LLM --> NUM[Numeric / dosage validator]

    CITE --> POLICY{Final safety policy}
    CLAIM --> POLICY
    NUM --> POLICY

    POLICY -->|safe| ANSWER[Answer]
    POLICY -->|caution| CAUTION[Answer with caution]
    POLICY -->|insufficient| ABSTAIN
    POLICY -->|unsafe| SAFE
Loading

πŸ“š Offline Evidence Pipeline

flowchart LR
    PDF[Medical PDFs] --> EXT[Text extraction]
    EXT --> CLEAN[Cleaning]
    CLEAN --> CHUNK[Token-aware chunking]
    CHUNK --> META[Metadata enrichment]
    META --> EMB[BGE embeddings]
    EMB --> DB[(ChromaDB)]
Loading

Architecture notes

  • Dense and sparse retrieval remain separate before fusion.
  • Evidence sufficiency can stop generation before the LLM is allowed to answer.
  • Citation resolution is deterministic and separated from claim support.
  • Numbers, units, dosages, thresholds, and durations receive stricter validation.
  • The final policy can answer, caution, abstain, or redirect.

The reported values are engineering evaluation metrics, not clinical validation or a medical-accuracy claim.

Inspect MedFlow β†’


πŸŽ₯ 3. Code AI Proctor β€” AI Exam Monitoring Platform

A self-hosted exam platform connecting webcam inference to organization management, quizzes, incident persistence, teacher review, grading, and student appeals.

Repository code-ai-proctor
Stack YOLO Β· PyTorch Β· FastAPI Β· SQLAlchemy Β· HTML/CSS/JS
Capability Local visual inference connected to an auditable exam workflow
AI task Binary classification: cheating vs normal

πŸ—οΈ Runtime Architecture

flowchart LR
    CAM[Browser webcam] --> FRAME[Canvas snapshot]
    FRAME --> API[FastAPI /api/predict]
    API --> CROP[Center crop]
    CROP --> YOLO[YOLO classifier]
    YOLO --> TEMP[Temporal logic]
    TEMP -->|normal| CONT[Continue exam]
    TEMP -->|confirmed alert| INCIDENT[Cheating incident]
    INCIDENT --> DB[(SQLAlchemy database)]
    DB --> TEACH[Teacher review]
    TEACH --> GRADE[Grades / CSV export]
    DB --> APPEAL[Student appeal]
Loading

🧩 Platform Workflow

flowchart TD
    ORG[Organization] --> ACC[Teacher / student accounts]
    ACC --> CLASS[Teacher creates class]
    CLASS --> QUIZ[Teacher creates quiz]
    QUIZ --> JOIN[Student joins class]
    JOIN --> ATTEMPT[Quiz attempt]
    ATTEMPT --> PROCTOR[Live AI proctoring]
    PROCTOR --> REVIEW[Incident review]
    REVIEW --> RESULT[Grade / appeal workflow]
Loading

Architecture notes

  • YOLO inference runs locally with CUDA when available and CPU fallback otherwise.
  • Webcam frames are center-cropped before classification to avoid aspect-ratio distortion.
  • Batch probability and streak logic reduce single-frame instability.
  • Confirmed incidents are attached to the active quiz attempt and persisted for review.
  • Teacher notifications, acknowledgement, grading, CSV export, and student appeals extend the system beyond inference.

Inspect Code AI Proctor β†’


πŸ“Š Data / Machine Learning

4. Telco Customer Churn β€” PySpark ML

Big-data style churn analysis and binary classification using Spark DataFrames and MLlib.

Repository Telco-Customer-Churn-Project
Stack PySpark Β· Spark DataFrames Β· MLlib Β· Google Colab
Task Predict whether a telecom customer will churn
Model Logistic Regression
flowchart LR
    CSV[Telco churn CSV] --> SPARK[Spark DataFrame]
    SPARK --> EDA[Analysis]
    EDA --> CAT[Categorical columns]
    CAT --> IDX[StringIndexer]
    IDX --> OHE[OneHotEncoder]
    OHE --> FEAT[Feature vector]
    FEAT --> LR[Logistic Regression]
    LR --> EVAL[Accuracy Β· F1 Β· Precision Β· Recall Β· AUC]
    EVAL --> CM[Confusion matrix]
Loading

Inspect Telco Churn β†’


5. Student Performance Analysis

A compact exploratory analysis connecting study behavior, attendance, previous performance, final score, and pass/fail status.

Repository Student-Performance-Analysis
Stack Python Β· Pandas Β· Matplotlib Β· Google Colab
Focus Exploratory student-performance analysis and visualization
flowchart LR
    DATA[Student data] --> DF[Pandas DataFrame]
    DF --> QUALITY[Null checks]
    QUALITY --> STATUS[Derived Pass / Fail]
    STATUS --> STATS[Descriptive statistics]
    STATS --> REL[Hours Studied vs Final Score]
    REL --> VIZ[Matplotlib visuals]
    STATUS --> DIST[Pass / Fail distribution]
    DIST --> VIZ
Loading

Inspect Student Performance Analysis β†’


πŸš€ Core Skills

Artificial Intelligence Computer Vision Edge AI Machine Learning RAG LLM Systems Model Evaluation


πŸ› οΈ Tech Stack

Programming

Python C++ C Java Dart MATLAB

AI Β· Vision Β· ML

PyTorch TensorFlow Keras OpenCV ONNX Scikit-learn Hugging Face MLflow

Edge Β· Cloud Β· Applications

Raspberry Pi Arduino ESP32 Flutter Firebase FastAPI Azure AI Supabase

Data Β· Backend Β· DevOps

Pandas PySpark SQLite Docker Git GitHub Linux VS Code


πŸ“ Engineering Principles

01  Understand the failure mode before adding complexity.
02  Measure behavior before calling a component better.
03  Tie every metric to its exact evaluation context.
04  Separate retrieval, generation, validation, and product workflow.
05  Prefer inspectable architecture over black-box demos.
06  Move notebook β†’ inference β†’ API β†’ product.

πŸ“ˆ Evaluation & Evidence

Project Measured / inspectable evidence
Smart Basket mAP@0.5 = 96.89% Β· mAP@0.5:0.95 = 84.79%
MedFlow Precision@4 = 53.12% Β· Hit@4 = 87.50% Β· MRR β‰ˆ 0.7031
Code AI Proctor Local inference Β· temporal stabilization Β· incident persistence Β· review workflow
Telco Churn Accuracy Β· F1 Β· Precision Β· Recall Β· AUC Β· Confusion Matrix
Student Performance Descriptive statistics Β· relationship analysis Β· pass/fail visualization

πŸŽ“ Background

Education B.Sc. Artificial Intelligence Engineering β€” Mansoura University Β· Sep 2023 – Expected Feb 2027
Academic standing GPA 3.13 / 4.00 Β· Grade B+
Training Digital Egypt Pioneers Initiative β€” Microsoft AI & Data Science / Machine Learning Engineering Β· Sep 2025 – Jul 2026
Location Egypt πŸ‡ͺπŸ‡¬
πŸ“Š GitHub activity
GitHub stats Top languages

🎯 Current Focus

  • Computer Vision & Edge AI β€” detection / classification, efficient local inference, model-to-device integration.
  • RAG / LLM Systems β€” retrieval quality, evidence sufficiency, grounding, citation and claim validation.
  • Evaluation β€” measurable behavior, failure modes, and system-level iteration.
  • AI Product Engineering β€” model β†’ API β†’ workflow β†’ usable product.

🀝 Connect With Me

LinkedIn GitHub Portfolio Email


Adham Elsayed Β· AI Engineer Β· Egypt πŸ‡ͺπŸ‡¬

Build the model Β· Measure the behavior Β· Ship the system

Popular repositories Loading

  1. AdhamElsayedAI.github.io AdhamElsayedAI.github.io Public

    Personal portfolio website for AI and Computer Vision projects.

    HTML

  2. Student-Performance-Analysis Student-Performance-Analysis Public

    Data preprocessing and visualization project using Python.

    Jupyter Notebook

  3. Telco-Customer-Churn-Project Telco-Customer-Churn-Project Public

    Jupyter Notebook

  4. Smart-Basket Smart-Basket Public

    Jupyter Notebook

  5. code-ai-proctor code-ai-proctor Public

    Python

  6. Medflow Medflow Public

    Forked from nadaakhatab/medflow

    Evidence-grounded thyroid clinical AI platform with RAG, transparent citations, claim verification, and safety guardrails.

    Python