README.md

---
title: Museum AI Studio
emoji: 🎬
colorFrom: blue
colorTo: purple
sdk: docker
app_file: app.py
pinned: false
---

# 🎬 Museum AI Studio

A unified interactive web experience combining 5 ML demos into one app!

**Live App:** [https://huggingface.co/spaces/Daniel-solo/museum-ai-studio](https://huggingface.co/spaces/Daniel-solo/museum-ai-studio)

---

## 🎮 5 Interactive Modes

| Mode | Emoji | Description | Tech Stack |
|------|-------|-------------|------------|
| **Anime Studio** | 🎨 | Real-time anime/cartoon style transfer (Hayao/Ghibli, Shinkai) | AnimeGANv2 ONNX + FastAPI WebSocket |
| **Pose Challenge** | 🧘 | Strike poses against targets, score similarity | MediaPipe Pose (browser) |
| **Face Filters** | 😎 | AR face filters: glasses, cat, crown, mustache, anime eyes | MediaPipe Face Mesh (browser) |
| **Hand Painter** | ✋ | Draw on canvas with hand gestures | MediaPipe Hands (browser) |
| **Rock-Paper-Scissors** | ✊ | Play RPS against AI using hand gestures | MediaPipe Hands + Server |

---

## 🚀 Quick Start

1. Allow camera access when prompted
2. Select a mode from the sidebar
3. In **Anime Studio**, wait for "Connected" then select style (Ghibli or Shinkai)
4. Use keyboard shortcuts: `1`-`5` to switch modes

---

## 📦 Combined from Original Demos

This app is a unified version of 5 demos from [Daniel-solo/museum-ml-demos](https://huggingface.co/datasets/Daniel-solo/museum-ml-demos):
- Demo 04 → 🧘 Pose Challenge
- Demo 05 → 🎨 Anime Studio (replaced .t7 models with AnimeGANv2)
- Demo 08 → ✊ Rock-Paper-Scissors
- Demo 10 → 😎 Face Filters
- Hand Conductor concept → ✋ Hand Painter

---

## 🛠️ Tech Stack

- **Backend:** FastAPI, Uvicorn, ONNX Runtime, OpenCV, HuggingFace Hub
- **Frontend:** Vanilla JS, HTML5 Canvas, MediaPipe Tasks Vision (CDN)
- **Models:** AnimeGANv2 Hayao/Shinkai (ONNX, 8.2MB each)
- **Deployment:** Hugging Face Spaces (Docker)

---

*Built with ❤️ for interactive museum exhibits.*