Running from source: Mac - smart-underworld/seestar_alp GitHub Wiki

Overview

Mac systems have a UNIX underpinning, and are ideal for running python based programs (which SSC is)

Installing

To automatically set up a Mac for Seestar_alp, run the following command in Terminal (or similar)

curl -s https://raw.githubusercontent.com/smart-underworld/seestar_alp/main/mac/setup.sh | bash

This will:

  1. Clone the seestar_alp software from github
  2. Install the python dependencies needed for the application in a python virtual environment
  3. Modify your shell (~/.zprofile) to use the new python virtual environment

Updating

Automatically

Run:

cd seestar_alp
./mac/update.sh
source ~/.zshrc

NOTE: The last line is needed before starting SSC in the same shell as the update happens - otherwise, the proper version of python will not be found.

The alternative is to launch a new shell window, for it to be automatically picked up as part of the shell initialization.

Manually

cd seestar_alp
git pull
pip install -r requirements.txt

Also see Python virtualenv on a mac for details on python virtual environments.

Running

cd seestar_alp
python3 ./root_app.py

Once you see the message "Startup Complete" - the web interface should be available in your browser at http://localhost:5432/