GUIA

GUIA

作为静态网站，帮助访客规划博物馆参观，用文字搜索艺术品，收藏喜欢的作品，并在室内地图上沿步行路线前往。

由 feifanjasmineguan 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：GUIA 是 MET 博物馆的智能导览。它是一个静态网站，访客可以用文字搜索艺术品，给喜欢的作品点心，获得来自库房的推荐，并在博物馆的室内地图上看到步行路线。另一个面向策展人的视图，按访客互动的多少给库房中的藏品排名。

适合谁：想为参观做计划的博物馆访客，以及想知道哪些库房藏品受访客关注的策展人。

行业 | 谁在用 | 怎么用 | 例子
博物馆 | 访客 | 搜索艺术品并沿路线前往 | 给一幅画点心，再在地图上走过去
博物馆 | 策展人 | 查看哪些库房藏品受关注 | 打开库房藏品的排行榜
教育 | 学生和艺术爱好者 | 在相似作品旁边看一件艺术品 | 打开单件艺术品页面
软件 | 网页开发者 | 研究一个带地图的原生 JavaScript 网站 | 阅读 map.js 和 api.js

需要现成、已托管的博物馆产品的人可以跳过它，因为这些页面需要先设置后端 Space 的地址。

用在哪里：

• 浏览器，访问 Hugging Face 上的这个 Space
• Windows、macOS 或 Linux，用于在网页浏览器中打开的副本
• 8000 端口的本地网页服务器，用于开发，后端在 7860 端口

用例 | 谁用 | 得到什么
规划参观 | 访客 | 排好序的艺术品、库房推荐和一条路线
查看单件艺术品 | 访客 | 博物馆的实时详情和一排相似作品
观察访客兴趣 | 策展人 | 库房藏品的实时排名

如何设置：

• Python 和 pip，用来获取文件
• 一个网页浏览器
• 在发布自己的副本之前，把后端 Space 的地址设为 config.js 里的 API_BASE

1. 安装 Hugging Face 的 hub 软件包。
2. 用 hf 命令下载这个 Space。
3. 进入新建的文件夹。
4. 在网页浏览器中打开 index.html。

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

本地开发时，README 从 frontend 文件夹启动一个简单的网页服务器，并在第二个终端里用 uvicorn 运行后端。

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

如何使用：在线使用时，访问 Hugging Face 上的这个 Space，在首页选择一个角色。在本地副本中，打开 index.html，用同样的方式选择。

工具 | 作用
index.html | 选择角色的首页
visitor.html | 文字搜索、点心、推荐和步行路线
gallery.html | 一件艺术品，附实时博物馆数据和相似作品
curator.html | 按访客互动给库房藏品做实时排名

示例：作为访客，你输入一个艺术品的搜索词，给几个结果点心，再看来自库房的推荐。然后地图会画出穿过博物馆各个展厅的步行路线。

新手与专家：如果你刚接触，访问这个 Space，选择访客角色，输入一次搜索。先给一个结果点心，就能看到路线和推荐是怎么根据你的选择来的。

如果你熟悉这个领域，这个网站用原生 JavaScript，室内地图用 MapLibre，还有一份预先生成的路线图，包含展厅、连接和楼层信息，约 4 MB，存放在 met_route_graph.json 里。测试时可以用查询字符串覆盖后端地址。代价是搜索和推荐依赖一个单独的后端。

你在首页选择角色
你搜索并给艺术品点心
后端排序并推荐
地图画出步行路线

注意事项：

• Backend: 页面会调用一个单独的后端 Space，它的地址在 config.js 里设置
• Data: 前端自带一个路线图文件
• License: mit
• Cost to run: 没有提到
• Data it reaches: 你配置的后端和来自 MET API 的实时艺术品详情，以及你的搜索和点心
• Not for: 完全离线使用，因为它需要后端

Hugging Face 上的数据（2026年11月13日）

• 点赞：5
• 构建方式：static
• 许可证：mit

链接

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

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。