Merge pull request 'perf(web): 4 MiB file streaming + 4 hypercorn workers (fix 40s downloads)' (#179) from dev into main

backend/app/__init__.py

@@ -34,6 +34,23 @@ def create_app() -> Quart:
     app = Quart(__name__)
     app.secret_key = cfg.secret_key
 
+    # Stream files in 4 MiB chunks instead of Quart's 8 KiB default. The image
+    # library lives on a CIFS/SMB share (mounted rsize=4 MiB), so 8 KiB reads
+    # meant ~19k network round-trips for one large original — 30–58s downloads
+    # that starved both the GPU agent and the browser (operator-flagged
+    # 2026-07-01). 4 MiB matches the mount's read size → one round-trip per read,
+    # ~500× fewer. buffer_size is the MAX read, so small thumbnails still read in
+    # a single gulp, and Range/mime/ETag/conditional handling lives on Response,
+    # so this keeps all of it. Guarded so a future Quart-internal change can't
+    # break boot — worst case we fall back to the slow default.
+    try:
+        from quart.wrappers.response import FileBody
+        FileBody.buffer_size = 4 * 1024 * 1024
+    except Exception:
+        logging.getLogger(__name__).warning(
+            "could not raise FileBody.buffer_size — file serving stays on 8 KiB chunks"
+        )
+
     for bp in all_blueprints():
         app.register_blueprint(bp)
     # Registered last so /api/* routes win over the SPA catch-all.

entrypoint.sh

@@ -12,9 +12,13 @@ case "$ROLE" in
     # create_app is a factory — the `()` tells hypercorn to call it once
     # and serve the returned Quart (ASGI) app, rather than treating the
     # function itself as the application (which it then mis-invokes as WSGI).
+    # Default 4 workers (was 2): each worker is one asyncio loop, and a large
+    # file download occupies its worker for the transfer — 2 was too few once the
+    # GPU agent + the browser's thumbnail grid hit /images concurrently (they
+    # queued behind each other). Env-tunable via HYPERCORN_WORKERS.
     exec hypercorn \
       --bind 0.0.0.0:8080 \
-      --workers "${HYPERCORN_WORKERS:-2}" \
+      --workers "${HYPERCORN_WORKERS:-4}" \
       --access-logfile - \
       "backend.app:create_app()"
     ;;