Skip to content

fix(packaging): bundle Python deps so .deb/AppImage start (v0.8.6)#6

Merged
I4cTime merged 1 commit intomainfrom
develop
Apr 15, 2026
Merged

fix(packaging): bundle Python deps so .deb/AppImage start (v0.8.6)#6
I4cTime merged 1 commit intomainfrom
develop

Conversation

@I4cTime
Copy link
Copy Markdown
Owner

@I4cTime I4cTime commented Apr 15, 2026

Problem

Packaged ProtonShift (.deb / AppImage) shipped only resources/python/src but ran python3 -m game_setup_hub.api without installing fastapi, uvicorn, or vdf on the system. The Python process exited immediately; Electron quit before opening a window.

Fix

  • Run pnpm run vendor-python before every dist* build: pip install -t electron/python-vendor from electron/python-runtime-requirements.txt.
  • Ship python-vendor as resources/python/vendor and prepend it to PYTHONPATH when packaged (electron/main.ts).
  • Log Python stderr in packaged mode too (was dev-only), so failures are visible from a terminal.
  • Version 0.8.6 — install the new .deb / AppImage after release.

README

Clarifies that official builds bundle the Python API stack; only python3 3.12+ is required from the OS.

Made with Cursor

The packaged app only shipped source under resources/python/src; the
backend imports FastAPI/Uvicorn/VDF which were not on PYTHONPATH, so
python3 exited immediately and the UI never opened.

Vendor wheels into resources/python/vendor before dist, prepend that
path when packaged, and log Python stderr in all modes for easier
diagnosis. Bump version to 0.8.6.

Made-with: Cursor
@I4cTime I4cTime merged commit e3f3b20 into main Apr 15, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant