Commit ·
2a9d63a
1
Parent(s): f5f56a5
Update README with custom Muse:Eye documentation
Browse files
README.md
CHANGED
|
@@ -1,73 +1,112 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
| 19 |
-
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
|
| 26 |
-
|
| 27 |
-
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
|
| 32 |
-
|
| 33 |
-
|
| 34 |
-
|
| 35 |
-
|
| 36 |
-
|
| 37 |
-
|
| 38 |
-
|
| 39 |
-
|
| 40 |
-
|
| 41 |
-
|
| 42 |
-
|
| 43 |
-
|
| 44 |
-
|
| 45 |
-
##
|
| 46 |
-
|
| 47 |
-
|
| 48 |
-
|
| 49 |
-
|
| 50 |
-
|
| 51 |
-
|
| 52 |
-
|
| 53 |
-
|
| 54 |
-
|
| 55 |
-
|
| 56 |
-
|
| 57 |
-
|
| 58 |
-
|
| 59 |
-
|
| 60 |
-
|
| 61 |
-
|
| 62 |
-
|
| 63 |
-
|
| 64 |
-
|
| 65 |
-
|
| 66 |
-
|
| 67 |
-
|
| 68 |
-
|
| 69 |
-
|
| 70 |
-
|
| 71 |
-
|
| 72 |
-
|
| 73 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
title: "Muse:Eye — On-device Multimodal XR Docent"
|
| 3 |
+
emoji: 🎨
|
| 4 |
+
colorFrom: blue
|
| 5 |
+
colorTo: purple
|
| 6 |
+
sdk: other
|
| 7 |
+
pipeline_tag: other
|
| 8 |
+
tags:
|
| 9 |
+
- multimodal
|
| 10 |
+
- XR
|
| 11 |
+
- on-device
|
| 12 |
+
- tflite
|
| 13 |
+
- mobileclip
|
| 14 |
+
- android
|
| 15 |
+
- unity
|
| 16 |
+
- RAG
|
| 17 |
+
- museum-tech
|
| 18 |
+
---
|
| 19 |
+
|
| 20 |
+
# Muse:Eye
|
| 21 |
+
**On-device Multimodal AI + XR Museum Docent for Android**
|
| 22 |
+
|
| 23 |
+
Muse:Eye는 **카메라 기반 작품 인식(MobileCLIP)**,
|
| 24 |
+
**온디바이스 LLM(Gemma-3N)**,
|
| 25 |
+
**XR 인터랙션(Unity MR)**
|
| 26 |
+
을 결합한 하이브리드 AI 도슨트 시스템입니다.
|
| 27 |
+
|
| 28 |
+
오프라인 환경에서도 빠른 이미지 검색,
|
| 29 |
+
메타데이터 기반 RAG,
|
| 30 |
+
성인/어린이/전문가 모드 설명 제공이 가능합니다.
|
| 31 |
+
|
| 32 |
+
---
|
| 33 |
+
|
| 34 |
+
# ✨ Features
|
| 35 |
+
|
| 36 |
+
### 1) ⚡ On-device AI (No Internet Required)
|
| 37 |
+
- MobileCLIP (TFLite) 이미지 임베딩
|
| 38 |
+
- 작품 유사도 검색 (FAISS → custom `.bin` index)
|
| 39 |
+
- Gemma-3N 온디바이스 LLM
|
| 40 |
+
|
| 41 |
+
### 2) 🖼 Artwork Recognition
|
| 42 |
+
- 카메라 인식 → 즉시 embedding 추출
|
| 43 |
+
- RAG 기반 작품·작가 설명 생성
|
| 44 |
+
|
| 45 |
+
### 3) 👶🧑🦳 Three Docent Modes
|
| 46 |
+
- 어린이 모드
|
| 47 |
+
- 성인 모드
|
| 48 |
+
- 전문가 모드
|
| 49 |
+
|
| 50 |
+
### 4) 🥽 XR Integrated
|
| 51 |
+
- Unity + Android Studio 통합
|
| 52 |
+
- MR 모드에서 3D UI 및 음성 안내 제공
|
| 53 |
+
|
| 54 |
+
---
|
| 55 |
+
# 🏗 System Architecture
|
| 56 |
+
|
| 57 |
+
Muse:Eye는 두 가지 실행 모드를 지원합니다:
|
| 58 |
+
|
| 59 |
+
- **Mobile Mode (On-device AI)** — 완전 오프라인
|
| 60 |
+
- **XR/MR Mode (Cloud Multimodal AI)** — Unity 기반 MR + Cloud API
|
| 61 |
+
|
| 62 |
+
---
|
| 63 |
+
|
| 64 |
+
## 📱 A. Mobile Mode (On-device AI)
|
| 65 |
+
|
| 66 |
+
```plaintext
|
| 67 |
+
Mobile App (Android)
|
| 68 |
+
│
|
| 69 |
+
├── Camera Input
|
| 70 |
+
│
|
| 71 |
+
├── MobileCLIP (TFLite)
|
| 72 |
+
│ └─ on-device embedding (512-d)
|
| 73 |
+
│
|
| 74 |
+
├── Embedding Index (.bin)
|
| 75 |
+
│ └─ cosine similarity search (offline)
|
| 76 |
+
│
|
| 77 |
+
├── Local Metadata RAG
|
| 78 |
+
│ └─ artwork metadata lookup
|
| 79 |
+
│
|
| 80 |
+
├── Gemma-3N On-device LLM
|
| 81 |
+
│ └─ adult / child / expert explanation
|
| 82 |
+
│
|
| 83 |
+
└── Android TTS
|
| 84 |
+
```
|
| 85 |
+
|
| 86 |
+
---
|
| 87 |
+
|
| 88 |
+
## 🥽 B. XR/MR Mode (Cloud Multimodal AI)
|
| 89 |
+
|
| 90 |
+
```plaintext
|
| 91 |
+
Unity XR App (MR View)
|
| 92 |
+
│
|
| 93 |
+
├── MR Camera (RenderTexture)
|
| 94 |
+
│
|
| 95 |
+
├── JNI Bridge → Android
|
| 96 |
+
│ └─ frame bytes 전달
|
| 97 |
+
│
|
| 98 |
+
├── Cloud Multimodal API (Gemini)
|
| 99 |
+
│ ├─ artwork analysis
|
| 100 |
+
│ ├─ style / meaning extraction
|
| 101 |
+
│ └─ multimodal reasoning
|
| 102 |
+
│
|
| 103 |
+
├── Cloud PromptManager
|
| 104 |
+
│ ├─ 어린이 모드
|
| 105 |
+
│ ├─ 성인 모드
|
| 106 |
+
│ └─ 전문가 모드
|
| 107 |
+
│
|
| 108 |
+
└── Unity 3D UI + Android TTS
|
| 109 |
+
├─ floating info panel
|
| 110 |
+
├── 3D guide elements
|
| 111 |
+
└── audio output
|
| 112 |
+
```
|