|
# One Click Installers for MacOS |
|
|
|
This document provide the details to build one click installers for MacOS. To manually build h2ogpt on MacOS follow steps at [README_MACOS.md](../../docs/README_MACOS.md). |
|
|
|
**Note**: Experimental and still under development. |
|
|
|
## Prerequisite |
|
|
|
- Need conda installed inorder to run the build script. |
|
- We use `PyInstaller` to build one click installer, it doesn't support cross platform builds. So the installers can |
|
be only built from Mac Machines. |
|
- Install tesseract & poppler on your Mac Machine |
|
|
|
## Build |
|
|
|
### Debug Mode (for one click installer developers) |
|
|
|
- Clone `h2ogpt` from https://github.com/h2oai/h2ogpt.git |
|
- Create conda environment and installer all required dependencies, consult [build_mac_installer.sh](build_mac_installer.sh) for more details. |
|
- Run below commands to build the installer |
|
```shell |
|
cd h2ogpt |
|
pyinstaller ./dev_installers/mac/mac_run_app.py -D -w --name=h2ogpt-osx-m1-cpu-debug --hiddenimport=h2ogpt --collect-all=h2ogpt --noconfirm --recursive-copy-metadata=transformers --collect-data=langchain --collect-data=gradio_client --collect-all=gradio --path=${CONDA_PREFIX}/python3.10/site-packages --collect-all=sentencepiece --add-data=./Tesseract-OCR:Tesseract-OCR --add-data=./poppler:poppler |
|
``` |
|
|
|
### Deployment Mode |
|
|
|
- Clone `h2ogpt` from https://github.com/h2oai/h2ogpt.git |
|
- For CPU only installer, run below commands to build the installer |
|
```shell |
|
cd h2ogpt |
|
. ./dev_installers/mac/build_mac_installer.sh |
|
``` |
|
- For MPS (GPU) supported installer, run below commands to build the installer |
|
```shell |
|
cd h2ogpt |
|
BUILD_MPS=1 . ./dev_installers/mac/build_mac_installer.sh |
|
``` |
|
|
|
## Run |
|
|
|
From MacOS finder, go to `h2ogpt/dist/` and double-click on the installer (i.e `h2ogpt-osx-m1-cpu`). |