refactor: Update Python version support and reorganize requirements files...

.github/workflows/ci.yml

@@ -70,6 +70,14 @@ jobs:
           pytest -q --cov=src --cov-report=xml:coverage.xml --cov-report=term
           # Single coverage dataset only; no secondary copying.
 
+      - name: Smoke launch (headless)
+        env:
+          QT_QPA_PLATFORM: offscreen
+          PHOTOSORT_ENABLE_FILE_LOGGING: 'false'
+        run: |
+          # Launch the app briefly in headless mode to catch startup regressions
+          timeout 20s python src/main.py --smoke-test --smoke-delay-ms 1500
+
       - name: Upload coverage XML
         uses: actions/upload-artifact@v4
         if: success() || failure()

.github/workflows/release-build.yml

@@ -148,7 +148,6 @@ jobs:
             --paths src `
             --paths . `
             --hidden-import core.build_info `
-            --hidden-import mediapipe `
             --add-data "src/ui/dark_theme.qss;." `
             --add-data "assets/app_icon.ico;." `
             --add-data "assets/app_icon.png;." `
@@ -163,8 +162,6 @@ jobs:
             --hidden-import torch `
             --hidden-import sklearn `
             --hidden-import sentence_transformers `
-            --collect-data mediapipe `
-            --collect-data pyiqa `
             --add-data "models;models" `
             --runtime-hook runtime_hook.py `
             src/main.py
@@ -219,7 +216,6 @@ jobs:
             --paths src \
             --paths . \
             --hidden-import core.build_info \
-            --hidden-import mediapipe \
             --add-data src/ui/dark_theme.qss:. \
             --add-data assets/app_icon.ico:. \
             --add-data assets/app_icon.png:. \
@@ -242,8 +238,6 @@ jobs:
             --hidden-import torch \
             --hidden-import sklearn \
             --hidden-import sentence_transformers \
-            --collect-data mediapipe \
-            --collect-data pyiqa \
             --add-data models:models \
             src/main.py
 

README.md

@@ -50,7 +50,7 @@ https://github.com/duartebarbosadev/photosort/releases
 
    > **Note**: These dependencies are only required on macOS. Windows and Linux users can skip this step.
 
-> **Python version:** PhotoSort currently targets Python 3.12 because several dependencies (e.g., MediaPipe) do not yet ship wheels for newer interpreters.
+> **Python version:** PhotoSort is tested on Python 3.12. Newer interpreters may work, but 3.12 is the supported target for now.
 
 3. **Create a Python 3.12 virtual environment (recommended):**
 

requirements-cuda.txt

@@ -1,16 +1,16 @@
-PyQt6
-rawpy
+diskcache
+numpy
+onnxruntime-gpu
+openai
+opencv-python
+piexif
 Pillow
 Pillow-heif
-sentence-transformers
+pyexiv2
+PyQt6
+rawpy
 scikit-learn
-torch
-diskcache
 send2trash
-opencv-python
-pyexiv2
-piexif
-onnxruntime-gpu
+sentence-transformers
+torch
 torchvision
-pyiqa
-mediapipe

requirements.txt

@@ -1,18 +1,16 @@
-PyQt6
-rawpy
+diskcache
+numpy
+onnxruntime
+openai
+opencv-python
+piexif
 Pillow
 Pillow-heif
-sentence-transformers
+pyexiv2
+PyQt6
+rawpy
 scikit-learn
-torch
-transformers
-safetensors
-diskcache
 send2trash
-opencv-python
-pyexiv2
-piexif
-onnxruntime
+sentence-transformers
+torch
 torchvision
-pyiqa
-mediapipe

src/main.py

@@ -9,6 +9,9 @@
     sys.path.insert(0, SRC_DIR)
 
 PROJECT_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+# Ensure the project root is on sys.path so top-level packages (e.g., workers/) are importable
+if PROJECT_ROOT not in sys.path:
+    sys.path.insert(0, PROJECT_ROOT)
 
 from core.runtime_paths import (  # noqa: E402
     is_frozen_runtime,
@@ -288,6 +291,17 @@ def main():
     parser.add_argument(
         "--clear-cache", action="store_true", help="Clear all caches before starting"
     )
+    parser.add_argument(
+        "--smoke-test",
+        action="store_true",
+        help="Start the UI and auto-exit after a short delay (for CI sanity checks)",
+    )
+    parser.add_argument(
+        "--smoke-delay-ms",
+        type=int,
+        default=2000,
+        help="Delay before auto-exit when --smoke-test is enabled (milliseconds)",
+    )
     args = parser.parse_args()
 
     # --- Aggressive Logging Setup ---
@@ -410,6 +424,13 @@ def apply_stylesheet():
         apply_stylesheet,
     )
 
+    if args.smoke_test:
+        delay_ms = max(200, args.smoke_delay_ms)
+        logging.info(
+            f"Smoke test mode enabled; will exit automatically after {delay_ms} ms"
+        )
+        QTimer.singleShot(delay_ms, app.quit)
+
     logging.info(
         f"Application setup complete in {time.perf_counter() - main_start_time:.4f}s. Entering event loop."
     )