Skip to content

MacOS Setup Guide

This guide will help you set up a macOS workstation to work with the code and develop Opteryx.

Both Intel/x86 and ARM environments are supported, but some parts of the guide may require additional steps for ARM.

Setting Up

1. Install Python

Python 3.11 recommended

We recommend using pyenv to install and manage Python environments. Follow the pyenv installation instructions for macOS.

2. Install pip

$ python -m ensurepip --upgrade

3. Install Git

First, update Homebrew:

$ brew update

Then, install Git:

$ brew install git

4. Install Rust

$ curl --proto '=https' --tlsv1.2 -sSf | sh

5. Clone the Repository

$ git clone

6. Install Dependencies

$ python -m pip install --upgrade -r requirements.txt
$ python -m pip install --upgrade setuptools setuptools_rust numpy cython

7. Build Binaries

$ python build_ext --inplace

Running Tests

To run the regression and unit tests:

First, install the optional dependencies, on intel-based Macs:

$ python -m pip install --upgrade -r tests/requirements.txt

On M-series (ARM) CPU Macs:

$ python -m pip install --upgrade -r tests/requirements_arm.txt

Then run the regression tests.

$ python -m pytest


Some tests require external services like GCS and Memcached and may fail if these have not been configured.