Local Install of Helix on macOS

Requirements

Docker

1. Install Docker Desktop by visiting the installer page and if this is your first time installing Docker Desktop, you may want to restart your computer after installation. Otherwise, Helix may not be able to find it in the later steps below.

Ollama

1. Install Ollama by visiting the installer page
2. Download Ollama Model (note - from here you need to open the terminal)

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.helixml.tech/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 ~/HelixML

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

docker compose up -d --remove-orphans

3. Confirm that all containers 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 registration process
   3. Complete user registration
3. To access the app, log in to the local HelixML UI with your registered user credentials