unsloth/.github
Daniel Han 4c85b8259e ci(mlx): expand macOS install ladder to match the Linux dep set
The first attempt installed only mlx + mlx-lm + pytest +
unsloth_zoo with --no-deps + unsloth -e --no-deps. That ladder
under-specifies what the MLX import branch in unsloth/__init__.py
actually needs:

  - The studio backend hardware module imports structlog at module
    top level. Without it tests/studio/test_hardware_dispatch_matrix.py
    fails at the very first `from utils.hardware import hardware as hw`
    with ModuleNotFoundError.
  - unsloth/__init__.py loads dataprep/raw_text.py via
    spec_from_file_location, which `from datasets import Dataset`. With
    --no-deps on unsloth-zoo neither datasets nor transformers nor any
    other shared dep got pulled in.

Mirror the Linux job's working ladder, with two MAC-specific
adjustments:

  - Drop bitsandbytes (CUDA-only).
  - Drop CPU torch (mlx replaces it on Apple Silicon, and unsloth-zoo
    already gates torch on `sys_platform != darwin or platform_machine != arm64`).
  - Install unsloth_zoo from git main WITH deps so pip resolves
    mlx + mlx-lm + mlx-vlm (gated on darwin+arm64 in the zoo's
    pyproject) plus the shared deps (datasets, transformers,
    sentencepiece, ...).

Validated locally against a Linux mac-sim venv (platform spoofed to
Darwin/arm64 via mlx_simulation, real datasets/transformers/structlog
installed via the same ladder, fake mlx via the shim):

  - Step 1 _IS_MLX activation: OK
  - Step 2 import each of unsloth_zoo.mlx_{loader,trainer,compile,utils,cce}
    + unsloth_zoo.gated_delta_vjp + FastMLXModel + MLXTrainer surface: OK
  - Step 3 36 tests across the three dispatch files: 36 passed in 0.43s

The Linux job (mlx-dispatch) is unchanged.
2026-05-07 03:11:05 +00:00
..
ISSUE_TEMPLATE Update issue template 2026-03-23 10:10:15 +05:30
workflows ci(mlx): expand macOS install ladder to match the Linux dep set 2026-05-07 03:11:05 +00:00
CODEOWNERS Update CODEOWNERS 2026-03-13 13:38:19 -07:00
dependabot.yml CI(security): defense-in-depth additions across 7 axes 2026-05-07 00:09:40 +00:00
FUNDING.yml Update FUNDING.yml (#3792) 2025-12-28 19:57:43 -08:00