Python UDF Setup Guide for macOS ARM (Apple Silicon)

[yokofly]

edit v1: remove conda

• Quick Start (macOS arm64)

• Step 1 — Prep folder

  • mkdir proton-test && cd proton-test

• Step 2 — Download artifacts

  • From the release https://github.com/timeplus-io/proton/releases/tag/v3.0.2 download:
    • proton-v3.0.2-Darwin-arm64 (server binary)
    • python-Darwin-arm64.tar.gz (bundled Python 3.10)
  • chmod +x ./proton-v3.0.2-Darwin-arm64

• Step 3 — Extract Python

  • tar -xzf ./python-Darwin-arm64.tar.gz
  • Confirm python/bin/python3.10 exists.

• Step 4 — First run (with bundled Python on PATH)

  • PATH="$PWD/python/bin:$PATH" ./proton-v3.0.2-Darwin-arm64 server

• Step 5 — Allow macOS Gatekeeper

  • Open System Settings → Privacy & Security.
  • Click “Allow Anyway”/“Open” for:
    • proton-v3.0.2-Darwin-arm64
    • python3.10 (bundled)
    • libpython3.10.dylib (bundled)
  • Stop the server (Ctrl+C), then run Step 4 again.

• Step 6 — Verify Python and manage packages

  • Client: ./proton-v3.0.2-Darwin-arm64 client
  • Check runtime: SELECT python_status();
  • List: SYSTEM LIST PYTHON PACKAGES;
  • Install numpy: SYSTEM INSTALL PYTHON PACKAGE 'numpy';
  • List again: SYSTEM LIST PYTHON PACKAGES;

• Step 7 — Where packages are installed

  • Default: proton-data/python/lib/python3.10/site-packages
  • Example check: ls proton-data/python/lib/python3.10/site-packages | grep numpy

• Tip — One-liner for repeated runs

  • PATH="$PWD/python/bin:$PATH" ./proton-v3.0.2-Darwin-arm64 server