README.md

metadata

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

---

🎮 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:

• 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.