Installation

Get Lucid installed on your Apple Silicon Mac.

Apple Silicon only

Lucid targets macOS on M1–M4 chips exclusively. Linux, Windows, and x86 are not supported.

Requirements

pip install lucid

If you manage multiple Python versions with pyenv or Conda, make sure you're on 3.12+:

python --version   # Python 3.12.x or later
pip install lucid

import lucid
print(lucid.__version__)  # 3.0.0

t = lucid.ones(3, 3, device="metal")
print(t.device)  # metal

All good

If both lines print without error, Lucid is installed correctly and the MLX GPU backend is active.

# Development tools (ruff, mypy, pytest)
pip install "lucid[dev]"

# Parity test suite against reference framework
pip install "lucid[test]"

pip install --upgrade lucid

git clone https://github.com/ChanLumerico/lucid.git
cd lucid
pip install -e ".[dev]"
cmake --build build/ -j$(sysctl -n hw.ncpu)

Building from source requires CMake ≥ 3.21, pybind11, and the full Xcode toolchain.