SAM3 Video Segmentation - Clean deployment

.gitattributes

@@ -0,0 +1,4 @@
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+
+sam3/perflib/tests/assets/masks.tiff filter=lfs diff=lfs merge=lfs -text
+assets/** filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,54 @@
+__pycache__/
+.DS_Store
+example_sam3_project_local/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+*.egg-info/
+.eggs/
+dist/
+build/
+
+# Source code protection
+# app.py is tracked in GitHub (private), but excluded in HuggingFace deployments
+# Use 'push-hf.sh' script to deploy to HuggingFace without app.py
+encrypt_code.py
+setup_hooks.sh
+cookie_util.py
+
+# Gradio
+flagged/
+gradio_cached_examples/
+
+# Outputs
+*.mp4
+!bedroom.mp4
+!football.mp4
+!openfield_5mice_3s.mp4
+!openfield_5mice_5min.mp4
+!openfield_5mice_6min.mp4
+!openfield_5mice_7min.mp4
+!examples/*.mp4
+
+# Model checkpoints
+*.pth
+*.ckpt
+checkpoints/
+
+# Logs
+*.log
+
+# IDE/editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+.env

LICENSE

@@ -0,0 +1,2 @@
+Unauthorized use of this code is prohibited.\n
+For inquiries regarding permissions, please send email to : bellmake@naver.com

README.md

@@ -0,0 +1,100 @@
+---
+title: SAM3 Video Segmentation and Tracking with Text Prompt
+emoji: 🎬
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+sdk_version: 5.9.1
+app_file: app_loader.py
+pinned: false
+---
+
+# 🎬 SAM3 Video Segmentation and Tracking with Text Prompt
+
+A HuggingFace Spaces app that automatically segments and tracks objects in videos using text prompts.
+
+## ✨ Key Features
+
+- **Text-driven segmentation**: Describe the target object in natural language
+- **Multiple objects**: Segment several objects at once by separating them with commas
+- **Temporal consistency**: Tracks objects across frames for stable masks
+- **Distinct colors**: Assigns unique colors for each object
+- **Live progress**: Watch processing updates in real time
+- **High-quality output**: Produces MP4 encoded with H.264 for broad compatibility
+
+## 🚀 How to Use
+
+1. **Upload a video**: Provide an MP4 file
+2. **Enter prompts**: Type the objects to segment
+   - Single object: `bed`, `person`, `car`, `dog`, etc.
+   - Multiple objects: `bed, pillow, person` (comma-separated)
+3. **Run**: Click the "🚀 Run Segmentation" button
+4. **Review results**: Preview and download the segmented video
+
+## 📋 Examples
+
+### Single-object segmentation
+```
+Prompt: bed
+Result: Only the bed is segmented and highlighted
+```
+
+### Multi-object segmentation
+```
+Prompt: bed, pillow, person
+Result: Bed, pillow, and person are segmented with unique colors
+```
+
+## 🛠️ Tech Stack
+
+- **Model**: SAM3 (Segment Anything Model 3)
+- **Framework**: Gradio
+- **Video processing**: OpenCV, FFmpeg
+- **Deep learning**: PyTorch
+
+## 📊 Performance & Limitations
+
+- **Processing time**: Scales with video length and resolution
+- **Multiple objects**: More objects increase runtime (roughly N objects ≈ N× time)
+- **GPU requirement**: GPU needed to run SAM3 efficiently
+- **Memory**: High-resolution videos require more memory
+
+## 🔧 Run Locally
+
+```bash
+# Clone the space
+git clone https://huggingface.co/spaces/bellmake/SAM3-video-segmentation-tracking
+cd SAM3-video-segmentation-tracking
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Start the app
+python app.py
+```
+
+## 📁 Project Structure
+
+```
+.
+├── app.py                          # Main Gradio app
+├── requirements.txt                # Python dependencies
+├── packages.txt                    # System packages (FFmpeg)
+├── bedroom.mp4                     # Sample video
+├── example_sam3_project_local/     # Local SAM3 project
+└── README.md                       # This file
+```
+
+## 🤝 Contributing
+
+Issues and pull requests are welcome!
+
+
+## 📄 License
+
+Unauthorized use of this code is prohibited.\n
+For inquiries regarding permissions, please send email to : bellmake@naver.com
+
+---
+
+**Powered by SAM3 & HuggingFace Spaces**

app_loader.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+"""
+Encrypted Code Loader - Hugging Face Space Entry Point
+
+This file decrypts and executes the encrypted app.py.
+DECRYPT_KEY must be stored in Hugging Face Space Secrets.
+"""
+
+import os
+import sys
+from cryptography.fernet import Fernet
+
+# List of files to decrypt
+ENCRYPTED_FILES = {
+    "app.py.encrypted": "app.py",
+}
+
+
+def decrypt_file(encrypted_path, decrypted_path, key):
+    """Decrypts an encrypted file."""
+    cipher = Fernet(key)
+    
+    # Read encrypted file
+    with open(encrypted_path, 'rb') as f:
+        encrypted_data = f.read()
+    
+    # Decrypt
+    try:
+        decrypted_data = cipher.decrypt(encrypted_data)
+    except Exception as e:
+        print(f"❌ Decryption failed for {encrypted_path}: {e}")
+        print("   Please check that DECRYPT_KEY is correctly set in Space Secrets.")
+        sys.exit(1)
+    
+    # Save decrypted file to temporary location (current directory in this case)
+    with open(decrypted_path, 'wb') as f:
+        f.write(decrypted_data)
+    
+    print(f"✓ Decrypted: {encrypted_path} → {decrypted_path} ({len(decrypted_data):,} bytes)")
+
+
+def main():
+    print("=" * 60)
+    print("🔓 Decrypting source code...")
+    print("=" * 60)
+    
+    # Get decryption key from Secrets
+    key_str = os.getenv("DECRYPT_KEY")
+    if not key_str:
+        print("❌ ERROR: DECRYPT_KEY not found in environment variables!")
+        print("   Please set DECRYPT_KEY in Hugging Face Space Secrets.")
+        print("   Go to: Settings → Variables and secrets → Add secret")
+        sys.exit(1)
+    
+    try:
+        key = key_str.encode('utf-8')
+        cipher = Fernet(key)  # Validate key
+    except Exception as e:
+        print(f"❌ Invalid DECRYPT_KEY: {e}")
+        sys.exit(1)
+    
+    print(f"✓ DECRYPT_KEY loaded from secrets")
+    print()
+    
+    # Decrypt files
+    for encrypted_file, decrypted_file in ENCRYPTED_FILES.items():
+        if not os.path.exists(encrypted_file):
+            print(f"⚠️  Warning: {encrypted_file} not found, skipping...")
+            continue
+        decrypt_file(encrypted_file, decrypted_file, key)
+    
+    print()
+    print("=" * 60)
+    print("✅ Decryption complete! Starting application...")
+    print("=" * 60)
+    print()
+    
+    # Execute decrypted app.py
+    # app.py automatically launches the Gradio app upon import
+    import app
+    
+    # Explicitly launch if a demo object exists
+    if hasattr(app, 'demo'):
+        print("✓ Launching Gradio app...")
+        app.demo.launch()
+
+
+if __name__ == "__main__":
+    main()

assets/bpe_simple_vocab_16e6.txt.gz

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:924691ac288e54409236115652ad4aa250f48203de50a9e4722a6ecd48d6804a
+size 1356917

assets/veval/toy_gt_and_pred/toy_saco_veval_sav_test_eval_res.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d491596003e0dd7742705ea17ab84375e468d3bca3464b831d9d504e550ff8e8
+size 12166

assets/veval/toy_gt_and_pred/toy_saco_veval_sav_test_gt.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4a1a964427d4e4225f883ed3d08ffa1d3613c45ac35dcc9426f2a25031c92a31
+size 3398949

assets/veval/toy_gt_and_pred/toy_saco_veval_sav_test_pred.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c593f97bb4701a8c34df38bfebaf9091c6ba4f056860a789c38877be6403652e
+size 542939