Skip to main content

A framework for machine learning on Apple silicon.

Project description

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},
}

Project details


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.31.0-py3-none-macosx_26_0_arm64.whl (47.9 MB view details)

Uploaded Python 3macOS 26.0+ ARM64

mlx_metal-0.31.0-py3-none-macosx_15_0_arm64.whl (38.6 MB view details)

Uploaded Python 3macOS 15.0+ ARM64

mlx_metal-0.31.0-py3-none-macosx_14_0_arm64.whl (38.6 MB view details)

Uploaded Python 3macOS 14.0+ ARM64

File details

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

File metadata

File hashes

Hashes for mlx_metal-0.31.0-py3-none-macosx_26_0_arm64.whl
Algorithm Hash digest
SHA256 7fd412f55ddf9f1d90c2cd86ce281d19e8eb93d093c6dbd784a49f8bd7d0a22c
MD5 8dd261fd275e3a3768bfe9224824a2a3
BLAKE2b-256 ed8fcdaffd759b4c71e74c294e773daacad8aafabac103b93e0aa56d4468d279

See more details on using hashes here.

Provenance

The following attestation bundles were made for mlx_metal-0.31.0-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.31.0-py3-none-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for mlx_metal-0.31.0-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 554dc7cb29e0ea5fb6941df42f11a1de385b095848e6183c7a99d7c1f1a11f5d
MD5 63037131cfbb0608ce219c9a88dd8e21
BLAKE2b-256 8d42c6d7bfd097b777f932d6cf8c79e41b565070b63cc452a069b8804e505140

See more details on using hashes here.

Provenance

The following attestation bundles were made for mlx_metal-0.31.0-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.31.0-py3-none-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for mlx_metal-0.31.0-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 1c572a6e3634a63060c103b0c38ac309e2d217be15519e3d8f0d6b452bb015f5
MD5 cd76c5b37d41b898e6c16ea60f96fad9
BLAKE2b-256 944f0a0671dfa62b59bf429edab0e2c9c7f9bc77865aa4218cd46f2f41d7d11a

See more details on using hashes here.

Provenance

The following attestation bundles were made for mlx_metal-0.31.0-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.

Supported by

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