Skip to content

Install on Windows

Oliver Tseng edited this page Nov 6, 2024 · 22 revisions

Latest

For installing UBA on Windows via WSL2, read https://github.com/eliranwong/UniqueBible/wiki/Install-UBA-on-Windows-via-WSL2-Ubuntu

Set up "Unique Bible App" on Windows

Basically, you simply need to download UBA and run it if you have Python and git in place.

Steps to set up for a fresh installation:

  1. Install Python and git

  2. Download UBA

  3. Run UBA

Prepare for Installation

UBA is a python-based application, so you need to have Python installed to run UBA.

Recommended Python version for running UBA: 3.8.10

There are several different ways to install Python, read more information at: https://www.python.org/downloads/

We found that it is pretty easy to install python and git ready with Chocolatey, so we will talk about chocolatey setup first.

Get chocolatey ready!

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell (Admin)"

  3. Enter the following command (copied from https://chocolatey.org/install):

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

Get python ready!

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell (Admin)"

  3. Enter the following command:

choco install python

refreshenv

Get git ready! [optional]

There are different ways to download UBA, we use git in the following example.

To install git,

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell (Admin)"

  3. Enter the following command:

choco install git

refreshenv

Don't want to use git? You can download a zip package of UBA and unzip it instead of using git:

https://github.com/eliranwong/UniqueBible/archive/main.zip

ATTENTION!

INSTRUCTIONS ABOVE: Use "Windows PowerShell (Admin)" instead of "Windows PowerShell"!!!

INSTRUCTIONS BELOW: Use "Windows PowerShell" instead of "Windows PowerShell (Admin)"!!!

Download UBA & Run

You simply need to download and run. Everything else will be set up for you automatically the first time you run UBA.

FOR THE REST BELOW: Use "Windows PowerShell" instead of "Windows PowerShell (Admin)"!!!

  1. Right-click Windows Icon, located at left lower corner

  2. Select and open "Windows PowerShell"

To download:

git clone https://github.com/eliranwong/UniqueBible

To run:

cd UniqueBible

python -m uniquebible.main

Alternative

You may also install Unique Bible App webtop version on Windows, read:

https://github.com/eliranwong/UniqueBible/wiki/UniqueBibleApp-webtop-on-Windows

Clone this wiki locally