Local Install of Helix on macOS

Requirements

Created on MacOS 15 - YMMV

1. Following instructions assume that you have Brew Package Installer installed

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Docker Desktop Brew Install Docker

brew install docker

NOTE: Make sure that you’re signed on to your Docker account

1. Install Ollama Server Brew Install Ollama

brew install ollama

2. Download Ollama Model

ollama pull llama3:instruct

1. Confirm that the model exists - values proceeding name of the model may differ

ollama ls | grep "llama3:instruct"

You should get a confirmation similar to this:

llama3:instruct               365c0bd3c000    4.7 GB    43 hours ago

Install Helix

Run installation script

curl -sL -O https://get.helix.ml/install.sh && bash install.sh

Successful completion of the installation

Spin up Helix Docker Instances

1. Change directory to location of HelixML payload is downloaded

cd /Users/"<yourLocalUser>"/HelixML

2. Launch Docker Desktop on your computer
3. Launch Docker Containers

docker compose up -d --remove-orphans

3. Confirm that all container are running and show a healthy status

Login to Helix UI

1. In a web browser go to: http://localhost:8080/
2. Register local user
   1. Bottom left pane - click on “Login/Register”
   2. Click on “Register” to begin the user registeration process
   3. Complete user registration
3. To access the app, log in to the local HelixML UI with your registered user credentials