Image Pipeline Playground
feat(backend): add desktop server entry and PyInstaller sidecar
Mohammad Rajaei55a257bc8bf0
diff --git a/backend/image_pipes_server.spec b/backend/image_pipes_server.specnew file mode 100644index 0000000..d7a0194--- /dev/null+++ b/backend/image_pipes_server.spec@@ -0,0 +1,95 @@+# -*- mode: python ; coding: utf-8 -*-+"""PyInstaller spec for the Image Pipes desktop backend sidecar."""++from __future__ import annotations++import sys+from pathlib import Path++from PyInstaller.building.api import COLLECT, EXE, PYZ+from PyInstaller.building.build_main import Analysis+from PyInstaller.utils.hooks import collect_all, collect_submodules++SPEC_ROOT = Path(SPECPATH).resolve()+BACKEND_ROOT = SPEC_ROOT+REPO_ROOT = BACKEND_ROOT.parent+FRONTEND_DIST = REPO_ROOT / "frontend" / "dist"+EXAMPLES_DIR = BACKEND_ROOT / "examples"++datas: list = []+binaries: list = []+hiddenimports: list = [+ "uvicorn.logging",+ "uvicorn.loops",+ "uvicorn.loops.auto",+ "uvicorn.protocols",+ "uvicorn.protocols.http",+ "uvicorn.protocols.http.auto",+ "uvicorn.protocols.websockets",+ "uvicorn.protocols.websockets.auto",+ "uvicorn.lifespan",+ "uvicorn.lifespan.on",+ "app.main",+ "app.nodes",+ "multipart",+ "email.mime.multipart",+]++for package in ("albumentations", "cv2", "scipy", "sklearn", "pydantic", "anyio", "starlette"):+ try:+ collected = collect_all(package)+ except Exception:+ continue+ datas += collected[0]+ binaries += collected[1]+ hiddenimports += collected[2]++hiddenimports += collect_submodules("app")++if FRONTEND_DIST.exists():+ datas.append((str(FRONTEND_DIST), "frontend/dist"))+if EXAMPLES_DIR.exists():+ datas.append((str(EXAMPLES_DIR), "examples"))++a = Analysis(+ [str(BACKEND_ROOT / "run_server.py")],+ pathex=[str(BACKEND_ROOT)],+ binaries=binaries,+ datas=datas,+ hiddenimports=hiddenimports,+ hookspath=[],+ hooksconfig={},+ runtime_hooks=[],+ excludes=[],+ noarchive=False,+ optimize=0,+)+pyz = PYZ(a.pure)++exe = EXE(+ pyz,+ a.scripts,+ [],+ exclude_binaries=True,+ name="image-pipes-server",+ debug=False,+ bootloader_ignore_signals=False,+ strip=False,+ upx=False,+ console=True,+ disable_windowed_traceback=False,+ argv_emulation=False,+ target_arch=None,+ codesign_identity=None,+ entitlements_file=None,+)++coll = COLLECT(+ exe,+ a.binaries,+ a.datas,+ strip=False,+ upx=False,+ upx_exclude=[],+ name="image-pipes-server",+)diff --git a/backend/pyproject.toml b/backend/pyproject.tomlindex 658c6ea..b0448c2 100644--- a/backend/pyproject.toml+++ b/backend/pyproject.toml@@ -20,6 +20,7 @@ dev = ["pytest>=8.3.0","ruff>=0.8.0","httpx>=0.28.0",+ "pyinstaller>=6.11.0",][build-system]diff --git a/backend/run_server.py b/backend/run_server.pynew file mode 100644index 0000000..8e47dbd--- /dev/null+++ b/backend/run_server.py@@ -0,0 +1,54 @@+"""Desktop / production server entrypoint for Image Pipes."""++from __future__ import annotations++import os+import sys+from pathlib import Path+++def _prepare_environment() -> None:+ """Ensure import paths and data dirs work for source and frozen builds."""+ if getattr(sys, "frozen", False):+ # PyInstaller one-folder / one-file layout+ bundle_dir = Path(getattr(sys, "_MEIPASS", Path(sys.executable).parent))+ backend_root = Path(sys.executable).resolve().parent+ if str(bundle_dir) not in sys.path:+ sys.path.insert(0, str(bundle_dir))+ frontend_dist = bundle_dir / "frontend" / "dist"+ if not frontend_dist.exists():+ frontend_dist = backend_root / "frontend" / "dist"+ os.environ.setdefault("IMAGE_PIPES_FRONTEND_DIST", str(frontend_dist))+ # Prefer examples next to the executable for template Load Image paths.+ examples = backend_root / "examples"+ if examples.exists():+ os.chdir(backend_root)+ else:+ backend_root = Path(__file__).resolve().parent+ if str(backend_root) not in sys.path:+ sys.path.insert(0, str(backend_root))+ repo_frontend = backend_root.parent / "frontend" / "dist"+ if repo_frontend.exists():+ os.environ.setdefault("IMAGE_PIPES_FRONTEND_DIST", str(repo_frontend))+ os.chdir(backend_root)+++def main() -> None:+ _prepare_environment()++ host = os.environ.get("IMAGE_PIPES_HOST", "127.0.0.1")+ port = int(os.environ.get("IMAGE_PIPES_PORT", "8765"))++ import uvicorn++ uvicorn.run(+ "app.main:app",+ host=host,+ port=port,+ log_level=os.environ.get("IMAGE_PIPES_LOG_LEVEL", "info"),+ factory=False,+ )+++if __name__ == "__main__":+ main()diff --git a/backend/uv.lock b/backend/uv.lockindex 4568167..ca3d9ad 100644--- a/backend/uv.lock+++ b/backend/uv.lock@@ -41,6 +41,15 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/8e/64/013409c451a44b61310fb757af4527f3de57fc98a00f40448de28b864290/albumentations-2.0.8-py3-none-any.whl", hash = "sha256:c4c4259aaf04a7386ad85c7fdcb73c6c7146ca3057446b745cc035805acb1017", size = 369423, upload-time = "2025-05-27T21:23:15.609Z" },]+[[package]]+name = "altgraph"+version = "0.17.5"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/7e/f8/97fdf103f38fed6792a1601dbc16cc8aac56e7459a9fff08c812d8ae177a/altgraph-0.17.5.tar.gz", hash = "sha256:c87b395dd12fabde9c99573a9749d67da8d29ef9de0125c7f536699b4a9bc9e7", size = 48428, upload-time = "2025-11-21T20:35:50.583Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/a9/ba/000a1996d4308bc65120167c21241a3b205464a2e0b58deda26ae8ac21d1/altgraph-0.17.5-py2.py3-none-any.whl", hash = "sha256:f3a22400bce1b0c701683820ac4f3b159cd301acab067c51c653e06961600597", size = 21228, upload-time = "2025-11-21T20:35:49.444Z" },+]+[[package]]name = "annotated-doc"version = "0.0.5"@@ -227,6 +236,7 @@ dependencies = [[package.dev-dependencies]dev = [{ name = "httpx" },+ { name = "pyinstaller" },{ name = "pytest" },{ name = "ruff" },]@@ -247,6 +257,7 @@ requires-dist = [[package.metadata.requires-dev]dev = [{ name = "httpx", specifier = ">=0.28.0" },+ { name = "pyinstaller", specifier = ">=6.11.0" },{ name = "pytest", specifier = ">=8.3.0" },{ name = "ruff", specifier = ">=0.8.0" },]@@ -260,6 +271,18 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },]+[[package]]+name = "macholib"+version = "1.16.4"+source = { registry = "https://pypi.org/simple" }+dependencies = [+ { name = "altgraph" },+]+sdist = { url = "https://files.pythonhosted.org/packages/10/2f/97589876ea967487978071c9042518d28b958d87b17dceb7cdc1d881f963/macholib-1.16.4.tar.gz", hash = "sha256:f408c93ab2e995cd2c46e34fe328b130404be143469e41bc366c807448979362", size = 59427, upload-time = "2025-11-22T08:28:38.373Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/c7/d1/a9f36f8ecdf0fb7c9b1e78c8d7af12b8c8754e74851ac7b94a8305540fc7/macholib-1.16.4-py2.py3-none-any.whl", hash = "sha256:da1a3fa8266e30f0ce7e97c6a54eefaae8edd1e5f86f3eb8b95457cae90265ea", size = 38117, upload-time = "2025-11-22T08:28:36.939Z" },+]+[[package]]name = "numpy"version = "2.4.6"@@ -425,6 +448,15 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },]+[[package]]+name = "pefile"+version = "2024.8.26"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/03/4f/2750f7f6f025a1507cd3b7218691671eecfd0bbebebe8b39aa0fe1d360b8/pefile-2024.8.26.tar.gz", hash = "sha256:3ff6c5d8b43e8c37bb6e6dd5085658d658a7a0bdcd20b6a07b1fcfc1c4e9d632", size = 76008, upload-time = "2024-08-26T20:58:38.155Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/54/16/12b82f791c7f50ddec566873d5bdd245baa1491bac11d15ffb98aecc8f8b/pefile-2024.8.26-py3-none-any.whl", hash = "sha256:76f8b485dcd3b1bb8166f1128d395fa3d87af26360c2358fb75b80019b957c6f", size = 74766, upload-time = "2024-08-26T21:01:02.632Z" },+]+[[package]]name = "pillow"version = "12.3.0"@@ -645,6 +677,46 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },]+[[package]]+name = "pyinstaller"+version = "6.21.0"+source = { registry = "https://pypi.org/simple" }+dependencies = [+ { name = "altgraph" },+ { name = "macholib", marker = "sys_platform == 'darwin'" },+ { name = "packaging" },+ { name = "pefile", marker = "sys_platform == 'win32'" },+ { name = "pyinstaller-hooks-contrib" },+ { name = "pywin32-ctypes", marker = "sys_platform == 'win32'" },+ { name = "setuptools" },+]+sdist = { url = "https://files.pythonhosted.org/packages/d5/4d/ec706c3fcf39e26888c35b39615ff4d5865d184069666c47492cff1fbe50/pyinstaller-6.21.0.tar.gz", hash = "sha256:bb9fab705983e393a2d1cac77d6972513057ad800215fd861dc15ff5272e98fd", size = 4061519, upload-time = "2026-06-13T14:15:06.25Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/0c/4a/53cf98bf66daed012dc9cd78c8203f19a675d696f2fc12afcf8c5049a0e0/pyinstaller-6.21.0-py3-none-macosx_10_13_universal2.whl", hash = "sha256:327d132389f37912609e01be62810cf96b5aa95b613903e4b8692e0d12fb0eda", size = 1052350, upload-time = "2026-06-13T14:13:55.88Z" },+ { url = "https://files.pythonhosted.org/packages/30/83/b591295c352ef464c50b4c6ffff1c4f771d875c9e833f578d1b9f564f6b3/pyinstaller-6.21.0-py3-none-manylinux2014_aarch64.whl", hash = "sha256:7071d4b094d5b40deeef5fa3d3b98a1b846087f7562b49209663d5f9281fe251", size = 748477, upload-time = "2026-06-13T14:14:00.327Z" },+ { url = "https://files.pythonhosted.org/packages/3d/8f/88fff4e403873b1e22286911350e75ff00db014aa08e57045da9d4328993/pyinstaller-6.21.0-py3-none-manylinux2014_i686.whl", hash = "sha256:6b6374d652107dd4a2eeece903ff82bb4045bb5e1006c5a158a6dcdbefe84bf2", size = 760877, upload-time = "2026-06-13T14:14:04.836Z" },+ { url = "https://files.pythonhosted.org/packages/8a/13/f0e48fbdfd1d05d948157121cea8b1b823dcb89efe6934b71fdd8bdb3f0f/pyinstaller-6.21.0-py3-none-manylinux2014_ppc64le.whl", hash = "sha256:4e3108b3f02384560da70e39b8bf22b0ad597d02bd68a40d76ea91c1cfa00cad", size = 759194, upload-time = "2026-06-13T14:14:10.61Z" },+ { url = "https://files.pythonhosted.org/packages/dd/d5/ea7878cf9924ed30d946d8288777424e6d069d94f5bde56b4d0890069664/pyinstaller-6.21.0-py3-none-manylinux2014_s390x.whl", hash = "sha256:697532279f535ad572bda613db4f821540e235c7854ca6da4d3bf0373f4415ee", size = 754979, upload-time = "2026-06-13T14:14:15.226Z" },+ { url = "https://files.pythonhosted.org/packages/9f/09/51b8905714b733bac66dbc041a7821372d70d888d273ae474c4037d4202d/pyinstaller-6.21.0-py3-none-manylinux2014_x86_64.whl", hash = "sha256:605169523a6b5ace39f13dfbff21add9f2bc43df99c7daf9394fefb2c45e8b6f", size = 754812, upload-time = "2026-06-13T14:14:20.264Z" },+ { url = "https://files.pythonhosted.org/packages/4b/43/d77779439d8c6c2e27a77bcfbd1d5cc0f568ebb611bb472b11af81b5f177/pyinstaller-6.21.0-py3-none-musllinux_1_1_aarch64.whl", hash = "sha256:5fa56746c1e76f93634d018502301378a2d0c382553d37d8c3c34ff436c12dd1", size = 753887, upload-time = "2026-06-13T14:14:25.268Z" },+ { url = "https://files.pythonhosted.org/packages/51/8f/c22df1f6837784ac349057ba693f08e7b1ca7a0e06f9c33c63bc6280007b/pyinstaller-6.21.0-py3-none-musllinux_1_1_x86_64.whl", hash = "sha256:42395ec76df8e8120c36b13339d9db8cab83e316a12839ee303cc00fc941bb74", size = 753779, upload-time = "2026-06-13T14:14:29.445Z" },+ { url = "https://files.pythonhosted.org/packages/c9/76/1ce8a27ce62ba8cf3a87c9ce6d575610f4e55d7cb0123e7512fc3f4b921a/pyinstaller-6.21.0-py3-none-win32.whl", hash = "sha256:c6b28d30d8fd99ce162ff3aab5013ed44dbfb747566b1f01b9bed7964d7c14e9", size = 1336462, upload-time = "2026-06-13T14:14:35.785Z" },+ { url = "https://files.pythonhosted.org/packages/c1/fa/ca1d7e5257dd8566a9dfc0dfb02f8a8075eeb53d4b2d3c579f1276759042/pyinstaller-6.21.0-py3-none-win_amd64.whl", hash = "sha256:7fae06c494ce0ebfe6bd3055c0e409def884f63af2e3705d06bd431ad9237fc7", size = 1397487, upload-time = "2026-06-13T14:14:42.328Z" },+ { url = "https://files.pythonhosted.org/packages/dc/75/21b51523ce8d96629b71311775a0a65f5f5a872124ab0de33e5c848f8bff/pyinstaller-6.21.0-py3-none-win_arm64.whl", hash = "sha256:f13c95c9c03fb567217135919f93815c305813126780b0ed6e0123cb8acaf025", size = 1346094, upload-time = "2026-06-13T14:14:48.914Z" },+]++[[package]]+name = "pyinstaller-hooks-contrib"+version = "2026.6"+source = { registry = "https://pypi.org/simple" }+dependencies = [+ { name = "packaging" },+]+sdist = { url = "https://files.pythonhosted.org/packages/94/5b/c9fe0db5e83ee1c39b2258fa21d23b15e1a60786b6c5990ee5074ead8bb6/pyinstaller_hooks_contrib-2026.6.tar.gz", hash = "sha256:bef5002c32f4f50bd55b005da12cff64eca8783e7eaf86a06a62410164bab725", size = 173354, upload-time = "2026-06-08T22:37:16.152Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/e7/31/f2d7343d8ed5f7c4678377886f6ce533e6eaaa131b252ce950114c2a7efa/pyinstaller_hooks_contrib-2026.6-py3-none-any.whl", hash = "sha256:fd13b8ac126b35361175edacd41a0d97080b75dd5f4b594ecefefff969509dd3", size = 457159, upload-time = "2026-06-08T22:37:14.722Z" },+]+[[package]]name = "pytest"version = "9.1.1"@@ -679,6 +751,15 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/e1/04/e8135ebd1ad02c56ec633277529b2602ff99ff634be76cdba5744cf554fd/python_multipart-0.0.32-py3-none-any.whl", hash = "sha256:ff6d3f776f16878c894e52e107296ffc890e913c611b1a4ec6c44e2821fe2e23", size = 30042, upload-time = "2026-06-04T16:18:57.319Z" },]+[[package]]+name = "pywin32-ctypes"+version = "0.2.3"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/85/9f/01a1a99704853cb63f253eea009390c88e7131c67e66a0a02099a8c917cb/pywin32-ctypes-0.2.3.tar.gz", hash = "sha256:d162dc04946d704503b2edc4d55f3dba5c1d539ead017afa00142c38b9885755", size = 29471, upload-time = "2024-08-14T10:15:34.626Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/de/3d/8161f7711c017e01ac9f008dfddd9410dff3674334c233bde66e7ba65bbf/pywin32_ctypes-0.2.3-py3-none-any.whl", hash = "sha256:8a1513379d709975552d202d942d9837758905c8d01eb82b8bcc30918929e7b8", size = 30756, upload-time = "2024-08-14T10:15:33.187Z" },+]+[[package]]name = "pyyaml"version = "6.0.3"@@ -887,6 +968,15 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/d5/19/969dc072906c84dd0a3b05dcf57ea750936087d7873549e408b35cfc3f97/scipy-1.18.0-cp314-cp314t-win_arm64.whl", hash = "sha256:368e0a705903c466aa5f08eefb39e6b1b6b2d659e7352a31fd9e2438365be0f8", size = 25279661, upload-time = "2026-06-19T15:01:40.817Z" },]+[[package]]+name = "setuptools"+version = "83.0.0"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/34/26/f5d29e25ffdb535afef2d35cdb55b325298f96debd670da4c325e08d70f4/setuptools-83.0.0.tar.gz", hash = "sha256:025bccbbf0fa05b6192bc64ae1e7b16e001fd6d6d4d5de03c97b1c1ade523bef", size = 1154254, upload-time = "2026-07-04T15:31:22.699Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/5d/40/e1e72872c6354b306daef1703549e8e83b4d43cfea356311bf722a043752/setuptools-83.0.0-py3-none-any.whl", hash = "sha256:29b23c360f22f414dc7336bb39178cc7bcbf6021ed2733cde173f09dba19abb3", size = 1008090, upload-time = "2026-07-04T15:31:20.885Z" },+]+[[package]]name = "simsimd"version = "6.5.16"