From 1455c15acd10c0aa2ec883d4fc209adffcc0b526 Mon Sep 17 00:00:00 2001
From: Mars <mars122@users.noreply.github.com>
Date: Fri, 14 Nov 2025 22:56:05 -0500
Subject: [PATCH 1/2] docs(runpod): add optional Docker/RunPod quickstart and
 ports guidance

---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/README.md b/README.md
index 1826488..dcf7f9e 100644
--- a/README.md
+++ b/README.md
@@ -70,6 +70,38 @@ cd DiffSplat
 bash settings/setup.sh
 ```
 
+### ▶️ Optional: Containerized quickstart (Docker/RunPod)
+
+If you prefer a batteries-included container with SSH, JupyterLab, and FileBrowser pre-wired, you can use the optional files under `docker/runpod/`.
+
+Build the image (from repo root):
+
+```bash
+docker build -f docker/runpod/Dockerfile -t diffsplat-runpod .
+```
+
+Run locally with GPU (Docker Desktop + WSL2 on Windows/macOS, or native Linux):
+
+```bash
+docker run --gpus all \
+    -p 22:22 -p 80:80 -p 9090:9090 -p 9999:9999 \
+    -e JUPYTER_PASSWORD=changeme \
+    diffsplat-runpod
+```
+
+Services inside the container:
+
+- SSH: port 22 (key-based auth; set `PUBLIC_KEY` to inject your key)
+- JupyterLab: port 9999 (`--ip=0.0.0.0`, `--no-browser`; use token from logs or `JUPYTER_PASSWORD`)
+- FileBrowser: port 9090
+- Nginx: port 80 (optional welcome)
+
+On RunPod, map these ports in the UI. HTTP ports (80/9090/9999) will be proxied to `https://<pod>-<port>.proxy.runpod.net/`. SSH is a raw TCP port; connect with:
+
+```bash
+ssh -i /path/to/key -p <mapped_port> root@<runpod_host>
+```
+
 
 ## 📊 Dataset
 

From e1c84e262eacf99e8cde3c33a6e01686d8849009 Mon Sep 17 00:00:00 2001
From: Mars <mars122@users.noreply.github.com>
Date: Fri, 14 Nov 2025 23:08:42 -0500
Subject: [PATCH 2/2] deps: pin requirements for reproducible installs (tested
 with Torch 2.3.1 cu121)

---
 settings/requirements.txt | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/settings/requirements.txt b/settings/requirements.txt
index 213453d..5b76316 100644
--- a/settings/requirements.txt
+++ b/settings/requirements.txt
@@ -1,24 +1,24 @@
-plyfile
-ipython
+plyfile==0.9
+ipython==8.26.0
 numpy==1.26.4
-matplotlib
-Pillow
-imageio
-imageio-ffmpeg
-rembg[gpu]
-lpips
-einops
-safetensors
-sentencepiece
-accelerate
-transformers
+matplotlib==3.8.4
+Pillow==10.3.0
+imageio==2.34.0
+imageio-ffmpeg==0.4.9
+rembg[gpu]==2.0.57
+lpips==0.1.4
+einops==0.7.0
+safetensors==0.4.3
+sentencepiece==0.2.0
+accelerate==0.30.1
+transformers==4.45.0
 diffusers==0.32
 kiui
-omegaconf
-pyarrow
-redis
-loguru
-pandas
+omegaconf==2.3.0
+pyarrow==15.0.2
+redis==5.0.1
+loguru==0.7.2
+pandas==2.2.2
 image-reward
 git+https://github.com/openai/CLIP.git
 deepspeed