chore: remove personal paths and album names from tooling

backend/app/realism_sources.py

@@ -133,12 +133,19 @@ def fetch_randomuser_people_photos(limit: int) -> list[RealismSample]:
 
 
 def fetch_local_people_photos(limit: int) -> list[RealismSample]:
-    """Fallback: local camera/people folders when remotes fail."""
-    roots = [
-        Path.home() / "Pictures" / "photos",
-        Path.home() / "Pictures" / "album",
-        Path.home() / "Pictures",
-    ]
+    """Fallback: local photo folders when remotes fail.
+
+    Set THR3SHR_LOCAL_PHOTO_DIRS to a pathsep/semicolon-separated list of dirs.
+    Defaults to ~/Pictures only (no personal album names).
+    """
+    import os
+
+    raw = os.environ.get("THR3SHR_LOCAL_PHOTO_DIRS", "").strip()
+    if raw:
+        sep = ";" if ";" in raw else os.pathsep
+        roots = [Path(p.strip()) for p in raw.split(sep) if p.strip()]
+    else:
+        roots = [Path.home() / "Pictures"]
     exts = {".jpg", ".jpeg", ".png", ".webp", ".jfif"}
     found: list[Path] = []
     for root in roots:
@@ -166,7 +173,6 @@ def fetch_local_people_photos(limit: int) -> list[RealismSample]:
         )
     return samples
 
-
 def fetch_commons_people_photos(limit: int) -> list[RealismSample]:
     """Pull real people photographs from Wikimedia Commons search."""
     if limit < 1:

backend/scripts/bench_batch_throughput.py

@@ -2,12 +2,12 @@
 """Compare WD single vs batched ORT throughput on local images.
 
 Usage (from backend/):
-  ../.venv/Scripts/python.exe scripts/bench_batch_throughput.py
-  ../.venv/Scripts/python.exe scripts/bench_batch_throughput.py --root "E:\\path" --n 24
+  ../.venv/Scripts/python.exe scripts/bench_batch_throughput.py --root /path/to/images --n 24
 """
 from __future__ import annotations
 
 import argparse
+import os
 import time
 from pathlib import Path
 
@@ -57,7 +57,8 @@ def main() -> int:
     parser = argparse.ArgumentParser()
     parser.add_argument(
         "--root",
-        default=r"/examples/inbox",
+        default=os.environ.get("THR3SHR_BENCH_ROOT", ""),
+        help="Image root (or set THR3SHR_BENCH_ROOT)",
     )
     parser.add_argument("--n", type=int, default=24)
     parser.add_argument("--model", default="wd_swinv2_v3")
@@ -65,6 +66,9 @@ def main() -> int:
     parser.add_argument("--batches", default="1,4,8")
     args = parser.parse_args()
 
+    if not str(args.root).strip():
+        raise SystemExit("Pass --root /path/to/images or set THR3SHR_BENCH_ROOT")
+
     root = Path(args.root)
     images = _collect_images(root, args.n)
     if len(images) < 4:

backend/scripts/debug_realism_probe.py

@@ -13,6 +13,7 @@ from __future__ import annotations
 
 import argparse
 import json
+import os
 import sqlite3
 import statistics
 import sys
@@ -80,20 +81,17 @@ PRIMARY_EVIDENCE_TAGS = (
     "3d_background",
 )
 
-# Auto-discovery candidates (first existing dirs with enough images win).
-DEFAULT_PHOTO_DIRS = [
-    Path(r"~/Pictures"),
-    Path(r"~/Pictures"),
-    Path(r"~/Pictures"),
-    Path(r"/examples/photos"),
-]
-DEFAULT_ANIME_DIRS = [
-    Path(r"/examples/anime/a"),
-    Path(r"/examples/anime/b"),
-    Path(r"/examples/anime/c"),
-    Path(r"/examples/anime/d"),
-    Path(r"/examples/anime/e"),
-    Path(r"~/Pictures"),
+# Optional local dirs via env (colon/semicolon-separated). Empty = Wikimedia fallbacks.
+def _env_dirs(name: str) -> list[Path]:
+    raw = os.environ.get(name, "").strip()
+    if not raw:
+        return []
+    sep = ";" if ";" in raw else os.pathsep
+    return [Path(p.strip()) for p in raw.split(sep) if p.strip()]
+
+
+DEFAULT_PHOTO_DIRS = _env_dirs("THR3SHR_PROBE_PHOTO_DIRS")
+DEFAULT_ANIME_DIRS = _env_dirs("THR3SHR_PROBE_ANIME_DIRS") + [
     Path(__file__).resolve().parents[2] / "sample_data" / "sfw_safebooru",
 ]
 
@@ -238,19 +236,25 @@ def collect_labeled_sets(
             if found:
                 photo_paths.extend(found)
                 notes.append(f"auto photo dir {d} (+{len(found)})")
-        # WhatsApp / obvious camera dumps at Pictures root
-        pics_root = Path(r"~/Pictures")
-        if pics_root.exists():
-            extras = []
-            for p in pics_root.iterdir():
-                if not p.is_file() or p.suffix.lower() not in IMAGE_EXTS:
-                    continue
-                name = p.name.lower()
-                if "whatsapp" in name or name.startswith("img_"):
-                    extras.append(p)
-            if extras:
-                photo_paths.extend(extras)
-                notes.append(f"auto Pictures root camera-like (+{len(extras)})")
+        # Optional: scan Pictures for WhatsApp / camera dumps when enabled
+        if os.environ.get("THR3SHR_PROBE_SCAN_PICTURES", "").strip().lower() in {
+            "1",
+            "true",
+            "yes",
+            "on",
+        }:
+            pics_root = Path.home() / "Pictures"
+            if pics_root.exists():
+                extras = []
+                for p in pics_root.iterdir():
+                    if not p.is_file() or p.suffix.lower() not in IMAGE_EXTS:
+                        continue
+                    name = p.name.lower()
+                    if "whatsapp" in name or name.startswith("img_"):
+                        extras.append(p)
+                if extras:
+                    photo_paths.extend(extras)
+                    notes.append(f"auto Pictures root camera-like (+{len(extras)})")
 
     anime_paths: list[Path] = []
     if anime_dir:

backend/scripts/run_realism_debug_eval.py

@@ -7,6 +7,7 @@ from __future__ import annotations
 
 import json
 import logging
+import os
 import sys
 from datetime import datetime, timezone
 from pathlib import Path
@@ -35,11 +36,13 @@ def _settings_from_db() -> AppSettings:
 
 
 def _probe_local_videos(settings: AppSettings, model: str, limit: int = 8) -> dict:
-    """Score local Organize videos with multi-frame pooling if present."""
-    roots = [
-        Path(settings.root_repo).expanduser() if settings.root_repo else None,
-        Path(r"/examples/library"),
-    ]
+    """Score local videos with multi-frame pooling if present."""
+    roots = []
+    if settings.root_repo:
+        roots.append(Path(settings.root_repo).expanduser())
+    extra = os.environ.get("THR3SHR_VIDEO_PROBE_ROOT", "").strip()
+    if extra:
+        roots.append(Path(extra).expanduser())
     videos: list[Path] = []
     for root in roots:
         if root is None or not root.is_dir():

backend/scripts/verify_all_taggers.py

@@ -2,11 +2,13 @@
 End-to-end verification of all tagger models against a small image folder.
 
 Usage (from backend/):
+  set THR3SHR_PROBE_ROOT=C:\\path\\to\\probe_images
   ../.venv/Scripts/python.exe scripts/verify_all_taggers.py
 """
 from __future__ import annotations
 
 import json
+import os
 import sys
 import time
 import urllib.error
@@ -14,8 +16,8 @@ import urllib.request
 from pathlib import Path
 
 API = "http://127.0.0.1:8000/api"
-ROOT = Path(r"/examples/probe")
-CATS = ROOT / "cats"
+ROOT = Path(os.environ.get("THR3SHR_PROBE_ROOT", "")).expanduser()
+CATS = ROOT / "cats" if ROOT.parts else Path("cats")
 # Keep selected tags broad enough that anime stills usually hit something.
 SELECTED = ["1girl", "solo", "long_hair", "blush", "smile"]
 MODELS = ["ml_danbooru", "wd_swinv2_v3", "wd_eva02_large"]
@@ -59,8 +61,12 @@ def wait_run(run_id: int, timeout_s: float = 1800.0) -> dict:
 
 
 def main() -> int:
-    if not ROOT.is_dir():
-        print(f"ERROR: probe root missing: {ROOT}", file=sys.stderr)
+    if not ROOT.parts or not ROOT.is_dir():
+        print(
+            "ERROR: set THR3SHR_PROBE_ROOT to a folder of probe images "
+            "(with optional cats/ subcategory root).",
+            file=sys.stderr,
+        )
         return 2
     CATS.mkdir(parents=True, exist_ok=True)
 
@@ -180,21 +186,30 @@ def main() -> int:
         if not ok:
             print(f"FAIL model={model}", file=sys.stderr)
 
-    # Restore the large Organize library paths for the user UI (tags preserved).
-    user_settings = req("GET", "/settings")
-    user_settings.update(
-        {
-            "root_repo": r"/examples/library",
-            "categories_root": r"/examples/categories",
-            "selected_tags": [],
-            "tagger_model": "wd_swinv2_v3",
-            "confidence_threshold": 0.6,
-            "wd_general_threshold": 0.35,
-            "max_inference_workers": 2,
-        }
-    )
-    req("PUT", "/settings", user_settings)
-    print("\nRestored UI settings to Organize library + wd_swinv2_v3", flush=True)
+    # Optionally restore durable library paths for the user UI (tags preserved).
+    restore_root = os.environ.get("THR3SHR_RESTORE_ROOT_REPO", "").strip()
+    restore_cats = os.environ.get("THR3SHR_RESTORE_CATEGORIES_ROOT", "").strip()
+    if restore_root and restore_cats:
+        user_settings = req("GET", "/settings")
+        user_settings.update(
+            {
+                "root_repo": restore_root,
+                "categories_root": restore_cats,
+                "selected_tags": [],
+                "tagger_model": "wd_swinv2_v3",
+                "confidence_threshold": 0.6,
+                "wd_general_threshold": 0.35,
+                "max_inference_workers": 2,
+            }
+        )
+        req("PUT", "/settings", user_settings)
+        print("\nRestored UI settings from THR3SHR_RESTORE_* env vars", flush=True)
+    else:
+        print(
+            "\nSkipped UI path restore (set THR3SHR_RESTORE_ROOT_REPO and "
+            "THR3SHR_RESTORE_CATEGORIES_ROOT to restore).",
+            flush=True,
+        )
 
     print("\n=== SUMMARY ===")
     all_ok = True