GUIA

GUIA

Helps visitors plan a museum visit, find artworks by text search, save favorites and follow a walking route on an indoor map, as a static site.

Made by feifanjasmineguan on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: GUIA is a smart guide for the MET museum. It is a static website where a visitor searches artworks by text, hearts the ones they like, gets recommendations from storage, and sees a walking route on the museum's indoor map. A second view for curators ranks pieces in storage by how often visitors interact with them.

Who it suits: Museum visitors who want a plan for their visit, and curators who want to see which stored pieces visitors care about.

Industry | Who uses it | How they use it | Example
Museums | Visitors | Search for art and follow a route | Heart a painting and walk to it on the map
Museums | Curators | See which stored pieces draw interest | Open the leaderboard of in-storage pieces
Education | Students and art lovers | Look at an artwork with similar works beside it | Open the single-artwork page
Software | Web developers | Study a vanilla JavaScript site with a map | Read map.js and api.js

Anyone who needs a ready, hosted museum product can skip it, since the pages need a backend Space address to be set.

Where to use it:

• A browser, by visiting the Space on Hugging Face
• Windows, macOS or Linux, for a copy you open in a web browser
• A local web server on port 8000, for development with a backend on port 7860

Use case | Who | What they get back
Plan a visit | Visitors | Ranked artworks, in-storage recommendations and a route
View one artwork | Visitors | Live museum details and a strip of similar works
Watch visitor interest | Curators | A live ranking of in-storage pieces

How to set it up:

• Python and pip, to fetch the files
• A web browser
• A backend Space address set as API_BASE in config.js, before you publish your own copy

1. Install the Hugging Face hub package.
2. Download the Space with the hf command.
3. Move into the new folder.
4. Open index.html in a web browser.

pip install -U huggingface_hub
hf download feifanjasmineguan/guia-for-art --repo-type space --local-dir guia-for-art
cd guia-for-art

For local development, the README starts a simple web server from the frontend folder and runs the backend with uvicorn in a second terminal.

cd guia-module3
python3 -m http.server 8000 --directory frontend

How to use it: Online, visit the Space on Hugging Face and pick a role on the landing page. In a local copy, open index.html and choose the same way.

Tool | What it does
index.html | Landing page where you pick a role
visitor.html | Text search, hearts, recommendations and a walking route
gallery.html | One artwork with live museum data and similar works
curator.html | Live ranking of in-storage pieces by visitor interaction

Example: As a visitor you type a search for an artwork, heart a few results, and look at the recommendations from storage. The map then draws a walking route through the museum rooms.

For newcomers and experts: If you are new, visit the Space, pick the visitor role and type one search. Hearting a result is the first small thing to try, and it shows how the route and recommendations come from your choices.

If you know the field, the site is vanilla JavaScript with MapLibre for the indoor map and a baked routing graph of rooms, edges and floor information, about 4 MB, stored in met_route_graph.json. A query string can override the backend address for testing. The trade-off is that search and recommendations rely on a separate backend.

You pick a role on the landing page
You search and heart artworks
The backend ranks and recommends
The map draws a walking route

Good to know:

• Backend: the pages call a separate backend Space whose address you set in config.js
• Data: a routing graph file ships with the frontend
• License: mit
• Cost to run: none named
• Data it reaches: the backend you configure and live artwork details from the MET API, plus your searches and hearts
• Not for: working fully offline, since it needs the backend

On Hugging Face, 13 November 2026

• Likes: 5
• Built with: static
• License: mit

Links

• Space: https://huggingface.co/spaces/feifanjasmineguan/guia-for-art
• Files: https://huggingface.co/spaces/feifanjasmineguan/guia-for-art/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.