Team Ai
Apppublic

andreped/wsi-visualization-demo

sourceHugging Faceupdated 2y agoView on Hugging Face
1likes
App README

wsi-visualization-demo

![license](https://github.com/andreped/wsi-visualization-demo/blob/main/LICENSE.md) <a target="_blank" href="https://huggingface.co/spaces/andreped/wsi-visualization-demo"><img src="https://img.shields.io/badge/🤗%20Hugging%20Face-Spaces-yellow.svg"></a>

Why?

This repository was developed to demonstrate how to do the following:

  • —Creating a simple web application for rendering a whole slide image in real time.
  • —Containerizing and deploying a web app for deployment on Hugging Face Spaces.

To access the live demo, click on the Hugging Face badge above. Below is a snapshot of the current state of the demo app.

<img width="1400" alt="demo-hf-spaces" src="https://github.com/user-attachments/assets/6cf9b9d5-4ea2-4cab-ac13-3a623edc1094">

Stack

For this demonstration, we have used the following:

ComponentDescription
OpenSeadragonThe actual library for rendering the WSI
Deep Zoom Image (DZI)Image file format compatible with OpenSeadragon
nginxHTTP web server
DockerContainerization of the web app
Hugging Face SpacesDeployment platform

Continuous integration

For this project, we continuously update the Hugging Face deployment for each commit to the main branch.

Build TypeStatus
HF Space Deploy![CI](https://github.com/andreped/wsi-visualization-demo/actions)
File Size Check![CI](https://github.com/andreped/wsi-visualization-demo/actions)

Docker

  1. 1.Build image:
docker build -t wsi-visualization .
  1. 1.Run image:
docker run -p 7860:7860 wsi-visualization
  1. 1.Open in browser:
open http://localhost:7860

License

This project has MIT License.