PanagiotisGidarakos/GLOVES

GLOVES : Global Counterfactual-based Visual Explanations

This repository contains the code for the Demo Paper submission for EDBT 2025.

Paper @ : https://openproceedings.org/2025/conf/edbt/paper-310.pdf

We introduce Global Counterfactual-based Visual Explanations (GLOVES), a visualization platform designed to enhance the explainability of decision-making systems through global counterfactual explanations (GCE). GLOVES focuses on visualizing global counterfactuals, calculated on top of a classifier’s decisions on an examined population, enabling users to explore and compare different configurations of GCE algorithms interactively.

Project Structure frontend/ This folder contains the source code for the web-based user interface of the GLOVES platform. Inside you can find also a detailed ReadMe.md file with the installation steps and the libraries used.

backend/ This folder contains the backend logic and APIs that power the frontend application. It is implemented using Python and FastAPI and inside the folder you can find a detailed description on how to run the API.

Our tool can be found online at http://gloves.imsi.athenarc.gr/. You can always cite us from https://openproceedings.org/2025/conf/edbt/paper-310.pdf

Project Structure

• —frontend/: Vite + React UI (copied from GLoVE_UI)
• —backend/: FastAPI service and methods (copied from GlanceDemoPaper-main)
• —Dockerfile: multi-stage image that builds frontend and serves backend + UI on port 7860

Hugging Face Space

This Space uses sdk: docker and starts:

uvicorn backend.app.main:app --host 0.0.0.0 --port 7860

Backend API is exposed under /api/* and the frontend is served by FastAPI from frontend/dist.

Local Run (without Docker)

1. 1.Install Python dependencies:

pip install -r backend/requirements.txt

1. 1.Build frontend:

cd frontend
npm ci
npm run build
cd ..

1. 1.Start backend:

uvicorn backend.app.main:app --host 0.0.0.0 --port 7860

1. 1.Open http://localhost:7860.