Fix ZeroGPU compatibility: Switch from Docker to Gradio SDK

BREAKING CHANGE: ZeroGPU requires Gradio SDK, not Docker SDK

Changes:
- Update README.md: sdk: docker -> sdk: gradio
- Add sdk_version: 5.9.1 and app_file: app.py
- Update requirements.txt: Use flexible version constraints for Python 3.10-3.12
- Update Dockerfile: Python 3.13 -> 3.12 (with note for local dev only)
- Add .dockerignore for cleaner Docker builds
- Clarify that Dockerfile is for local development only

ZeroGPU Configuration:
- SDK: Gradio (required for ZeroGPU)
- Python: 3.10-3.12 (3.13 not yet supported on HF Spaces)
- Dockerfile: Optional, for local development only

This fixes the "ZeroGPU is only available on Gradio SDK" error.

References:
- https://huggingface.co/docs/hub/spaces-config-reference
- https://huggingface.co/docs/hub/spaces-zerogpu

.dockerignore

@@ -0,0 +1,44 @@
+# Git files
+.git
+.gitignore
+.github
+
+# Python cache
+__pycache__
+*.py[cod]
+*$py.class
+.pytest_cache
+.mypy_cache
+.ruff_cache
+
+# Virtual environments
+venv
+env
+ENV
+.venv
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+*~
+
+# Generated files
+*.ply
+*.splat
+*.mp4
+*.avi
+*.mov
+gradio_cached_examples/
+flagged/
+tmp/
+temp/
+
+# Documentation
+README.md
+LICENSE
+*.md
+
+# CI/CD
+.github/

Dockerfile

@@ -1,3 +1,7 @@
+# Dockerfile for local development only
+# NOTE: Hugging Face Spaces uses Gradio SDK (not Docker) for ZeroGPU support
+# This Dockerfile is provided for local testing and development purposes
+
 FROM nvidia/cuda:12.4.0-cudnn-devel-ubuntu22.04
 
 # 環境変数
@@ -6,7 +10,7 @@ ENV DEBIAN_FRONTEND=noninteractive \
     GRADIO_SERVER_NAME=0.0.0.0 \
     GRADIO_SERVER_PORT=7860
 
-# システムパッケージの更新とPython 3.13のインストール
+# システムパッケージの更新とPython 3.12のインストール
 RUN apt-get update && apt-get install -y \
     software-properties-common \
     wget \
@@ -14,15 +18,15 @@ RUN apt-get update && apt-get install -y \
     && add-apt-repository ppa:deadsnakes/ppa \
     && apt-get update \
     && apt-get install -y \
-    python3.13 \
-    python3.13-dev \
-    python3.13-venv \
+    python3.12 \
+    python3.12-dev \
+    python3.12-venv \
     python3-pip \
     && rm -rf /var/lib/apt/lists/*
 
-# Python 3.13をデフォルトに設定
-RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.13 1 \
-    && update-alternatives --install /usr/bin/python python /usr/bin/python3.13 1
+# Python 3.12をデフォルトに設定
+RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1 \
+    && update-alternatives --install /usr/bin/python python /usr/bin/python3.12 1
 
 # pipのアップグレード
 RUN python3 -m pip install --upgrade pip setuptools wheel

README.md

@@ -3,7 +3,9 @@ title: SHARP 3D Gaussian Splats Generator
 emoji: 🎨
 colorFrom: blue
 colorTo: purple
-sdk: docker
+sdk: gradio
+sdk_version: 5.9.1
+app_file: app.py
 pinned: false
 license: mit
 tags:
@@ -76,14 +78,15 @@ PLYファイルをダウンロードして、Blender、CloudCompare、MeshLabな
 - **UI**: Gradio 5.9
 - **3Dレンダリング**: Three.js + PLYLoader
 - **GPU**: ZeroGPU (Nvidia H200)
-- **言語**: Python 3.13
+- **SDK**: Gradio SDK (ZeroGPU互換)
+- **言語**: Python 3.10-3.12
 
 ### 主要ライブラリ
 ```
-torch==2.5.1
-gsplat==1.5.3
+torch>=2.5.0
+gsplat>=1.5.0
 gradio==5.9.1
-timm==1.0.12
+spaces (ZeroGPU)
 ```
 
 ---
@@ -114,7 +117,7 @@ timm==1.0.12
 ## 🌐 ローカル実行
 
 ### 前提条件
-- Python 3.13
+- Python 3.10-3.12 (3.13はHugging Face Spacesで未対応)
 - CUDA 12.4+ (GPU使用の場合)
 - 8GB以上のVRAM推奨
 
@@ -124,6 +127,10 @@ timm==1.0.12
 git clone https://github.com/YUGOROU/ml-sharp_ZeroGPU.git
 cd ml-sharp_ZeroGPU
 
+# 仮想環境の作成 (推奨)
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+
 # 依存関係をインストール
 pip install -r requirements.txt
 
@@ -131,7 +138,9 @@ pip install -r requirements.txt
 python app.py
 ```
 
-### Dockerで実行
+### Dockerで実行 (オプション)
+**注意**: Hugging Face SpacesではGradio SDKを使用するためDockerは不要ですが、ローカル開発ではDockerを使用できます。
+
 ```bash
 # Dockerイメージをビルド
 docker build -t sharp-app .

requirements.txt

@@ -1,23 +1,23 @@
 # Core dependencies for SHARP
-torch==2.5.1
-torchvision==0.20.1
-timm==1.0.12
-gsplat==1.5.3
-scipy==1.14.1
-numpy==2.1.3
-pillow==11.0.0
-pillow-heif==0.20.0
-imageio==2.37.0
-imageio-ffmpeg==0.6.0
-click==8.1.8
-plyfile==1.1.2
-huggingface-hub==0.27.0
+torch>=2.5.0
+torchvision>=0.20.0
+timm>=1.0.0
+gsplat>=1.5.0
+scipy>=1.14.0
+numpy>=2.1.0,<3.0.0
+pillow>=11.0.0
+pillow-heif>=0.20.0
+imageio>=2.37.0
+imageio-ffmpeg>=0.6.0
+click>=8.1.0
+plyfile>=1.1.0
+huggingface-hub>=0.27.0
 
 # Gradio for UI
 gradio==5.9.1
 
-# Spaces GPU support
+# Spaces ZeroGPU support
 spaces
 
-# SHARP package from GitHub
+# SHARP package from GitHub (compatible with Python 3.10+)
 git+https://github.com/apple/ml-sharp.git