RescueBox mac tips

this is on a fresh environment on an Intel based Mac.

Clone https://github.com/UMass-Rescue/RescueBox/ and follow these steps:

1. Install Python 3.12

brew install python@3.12
# Tell poetry to use this intepreter
poetry env use 3.12   # or full path: Ex: /usr/local/bin/python3.12

2. Install poetry.

curl -sSL https://install.python-poetry.org/ | python3 -

3. Install ffmpeg (if not installed)

brew install ffmpeg

4. (OPTIONAL) If you are using a Mac with Intel CPU, torch depricated support for intel macs since version 2.2.2. Make the following changes to the root level pyproject.toml. Replace the first few lines (till numpy) in [tool.poetry.dependencies] with this.

[tool.poetry.dependencies]
torch = "2.2.2"
requests = "^2.32.3"
python = ">=3.11,<3.13"
pyyaml = "^6.0.2"
typer = "^0.12.5"
llvmlite = "^0.44.0"
pytest = "^8.3.4"
httpx = "^0.28.1"
# add dependencies common to all plugins here
numpy = "1.26.4"

5. Install poetry dependencies

poetry install

6. Run pytest to verify that tests pass

poetry run pytest

7. Run server

./run_server

8. Might need these before npm install

# Upgrade node if your node version is less than 14. (check with `node -v`)
brew install node@20
echo 'export PATH="/usr/local/opt/node@20/bin:$PATH"' >> ~/.zshrc

# Install python-setuptools since we're using python 3.12
brew install python-setuptools
# Or install it from https://pypi.org/project/setuptools/ into the python environment on your command line

9. Install UI dependencies

cd RescueBox-Desktop
npm install

10. Run UI

npm start

You should see the UI show up after this. Connect to your server and go to the "Models" tab to run the models.