Portable Python - eliranwong/UniqueBible GitHub Wiki

Portable Python

Allows running UBA on any computer by having a complete Python interpreter and UBA code on USB stick.

Prepare USB stick:

  • Verify USB has at least 16 GB free
  • Rename USB stick to "UBA_USB"

Download UBA:

  • Download UBA.zip
  • Unzip UBA zip onto hard disk

Minimize UBA:

  • In unzipped UBA folder, cd installation/portable-python then run python3 minimize.py to delete unused files (will delete over 84000 files).
  • If you don't do this, it will take forever to unzip all the files on the USB stick.

Mac (M1 or x86)

Download Portable Python:

Zip UBA:

  • Copy installation/portable-python/run*.sh to UBA root
  • Zip up the UBA folder that has deleted unused files and with the run scripts in the root

Copy to stick:

  • Copy Portable Python to stick and unzip
  • Rename Portable Python directory to either 3.10.8_m1 or 3.10.8_x86
  • Copy 'installation/portable-python/unquarantine.sh' to Portable Python directory and run ./unquarantine.sh. This will allow computer to run downloaded programs.
  • Copy UBA zip to stick and unzip and name the folder 'UniqueBible'.

Run UBA:

  • Execute run_m1.sh or run_x86.sh on USB in 'UniqueBible' folder
  • This will take awhile to create the venv folder on the USB

Notes:

  • On Mac, USB is under /Volumes
  • On Ubuntu, USB is under /media

Windows

Download Portable Python:

Copy to stick:

  • Run WinPython and install the Python directory on the USB stick
  • Copy UBA zip to stick and unzip

Run UBA:

  • In the WinPython directory, run WinPython Terminal.exe
  • This will open a terminal that has Python in the path
  • Execute cd D: to go to the USB stick
  • Execute cd UniqueBible to go into the UBA directory
  • Execute python uba.py to start UBA