Skip to main content

MLX

Quickstart | Installation | Documentation | Examples

CircleCI

MLX is an array framework for machine learning on Apple silicon, brought to you by Apple machine learning research.

Some key features of MLX include:

  • Familiar APIs: MLX has a Python API that closely follows NumPy. MLX also has fully featured C++, C, and Swift APIs, which closely mirror the Python API. MLX has higher-level packages like mlx.nn and mlx.optimizers with APIs that closely follow PyTorch to simplify building more complex models.

  • Composable function transformations: MLX supports composable function transformations for automatic differentiation, automatic vectorization, and computation graph optimization.

  • Lazy computation: Computations in MLX are lazy. Arrays are only materialized when needed.

  • Dynamic graph construction: Computation graphs in MLX are constructed dynamically. Changing the shapes of function arguments does not trigger slow compilations, and debugging is simple and intuitive.

  • Multi-device: Operations can run on any of the supported devices (currently the CPU and the GPU).

  • Unified memory: A notable difference from MLX and other frameworks is the unified memory model. Arrays in MLX live in shared memory. Operations on MLX arrays can be performed on any of the supported device types without transferring data.

MLX is designed by machine learning researchers for machine learning researchers. The framework is intended to be user-friendly, but still efficient to train and deploy models. The design of the framework itself is also conceptually simple. We intend to make it easy for researchers to extend and improve MLX with the goal of quickly exploring new ideas.

The design of MLX is inspired by frameworks like NumPy, PyTorch, Jax, and ArrayFire.

Examples

The MLX examples repo has a variety of examples, including:

Quickstart

See the quick start guide in the documentation.

Installation

MLX is available on PyPI. To install MLX on macOS, run:

pip install mlx

To install the CUDA backend on Linux, run:

pip install mlx[cuda]

To install a CPU-only Linux package, run:

pip install mlx[cpu]

Checkout the documentation for more information on building the C++ and Python APIs from source.

Contributing

Check out the contribution guidelines for more information on contributing to MLX. See the docs for more information on building from source, and running tests.

We are grateful for all of our contributors. If you contribute to MLX and wish to be acknowledged, please add your name to the list in your pull request.

Citing MLX

The MLX software suite was initially developed with equal contribution by Awni Hannun, Jagrit Digani, Angelos Katharopoulos, and Ronan Collobert. If you find MLX useful in your research and wish to cite it, please use the following BibTex entry:

@software{mlx2023,
  author = {Awni Hannun and Jagrit Digani and Angelos Katharopoulos and Ronan Collobert},
  title = {{MLX}: Efficient and flexible machine learning on Apple silicon},
  url = {https://github.com/ml-explore},
  version = {0.0},
  year = {2023},
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

mlx_metal-0.32.2-py3-none-macosx_26_0_arm64.whl (64.4 MB view details)

Uploaded Python 3macOS 26.0+ ARM64

mlx_metal-0.32.2-py3-none-macosx_15_0_arm64.whl (42.5 MB view details)

Uploaded Python 3macOS 15.0+ ARM64

mlx_metal-0.32.2-py3-none-macosx_14_0_arm64.whl (42.5 MB view details)

Uploaded Python 3macOS 14.0+ ARM64

File details

Details for the file mlx_metal-0.32.2-py3-none-macosx_26_0_arm64.whl.

File metadata

File hashes

Hashes for mlx_metal-0.32.2-py3-none-macosx_26_0_arm64.whl
Algorithm Hash digest
SHA256 e6abeac9ac5265830c9c1541b6f96e9be37a85c2446763a46ad466c63a3837ab
MD5 d8e151b84d7fbcc6f9c13c942ed66704
BLAKE2b-256 ddcd4e50bf325100e7165e13d025f264362bf0009196269f9eaf87f2c6e738a2

See more details on using hashes here.

Provenance

The following attestation bundles were made for mlx_metal-0.32.2-py3-none-macosx_26_0_arm64.whl:

Publisher: release.yml on ml-explore/mlx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mlx_metal-0.32.2-py3-none-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for mlx_metal-0.32.2-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 55a369250d220b2cf10213a87a2ac1b1a420608c5b35b1df4e7147ac8e32f121
MD5 d6d1f3f35c44a7f407f5aa112f8dccca
BLAKE2b-256 79ec34f37376e26d537fadffb99af3a760d6545e37f5e1a30a552baadf237fc5

See more details on using hashes here.

Provenance

The following attestation bundles were made for mlx_metal-0.32.2-py3-none-macosx_15_0_arm64.whl:

Publisher: release.yml on ml-explore/mlx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mlx_metal-0.32.2-py3-none-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for mlx_metal-0.32.2-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 3825fff379dbc107dd3413e564a06caeaa24819910ec49c0439e454c06a1b9b8
MD5 5c157b90c19855e3b2139189244066ca
BLAKE2b-256 f7abba1952908c5d2a5070cf1cfbfea0161c4751ea62299e2776819810917483

See more details on using hashes here.

Provenance

The following attestation bundles were made for mlx_metal-0.32.2-py3-none-macosx_14_0_arm64.whl:

Publisher: release.yml on ml-explore/mlx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.32.2 This release

3 files

0.32.1

3 files

0.32.0

3 files

0.31.2

3 files

0.31.1

3 files

0.31.0

3 files

0.30.6

3 files

0.30.5

3 files

0.30.4

3 files

0.30.3

3 files

0.30.1

3 files

0.30.0

3 files

0.29.4

2 files

0.29.3

3 files

0.29.2

3 files

0.29.1

3 files

0.29.0

3 files

0.28.0

3 files

0.27.1

3 files

0.26.5

3 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page