MLX: An array framework for Apple silicon
mlx
Go to file
2023-12-16 21:43:15 -08:00
.circleci Nits (#38) 2023-12-06 13:32:41 -08:00
.github fix: tidy pull request template (#143) 2023-12-12 08:14:39 -08:00
benchmarks Activations LeakyReLU / PReLU / Softplus / Mish (#109) 2023-12-11 19:40:57 -08:00
cmake jagrit's commit files 2023-11-29 10:52:08 -08:00
docs Add optimizers (AdaMax, AdaDelta, RMSprop) and ordering optimizer classes (#142) 2023-12-16 21:43:15 -08:00
examples accross -> across (#183) 2023-12-15 13:46:50 -08:00
mlx added tri / tril / triu (#170) 2023-12-15 17:30:34 -08:00
python Add optimizers (AdaMax, AdaDelta, RMSprop) and ordering optimizer classes (#142) 2023-12-16 21:43:15 -08:00
tests added tri / tril / triu (#170) 2023-12-15 17:30:34 -08:00
.clang-format awni's commit files 2023-11-29 10:30:41 -08:00
.gitignore Added stubs for python files generated from C++ (#136) 2023-12-14 12:58:45 -08:00
.pre-commit-config.yaml added tri / tril / triu (#170) 2023-12-15 17:30:34 -08:00
ACKNOWLEDGMENTS.md Add metal cpp license to acknowledgements (#3) 2023-11-30 11:33:23 -08:00
CMakeLists.txt Fixed typo in some proprietary terms. (#161) 2023-12-13 19:48:00 -08:00
CODE_OF_CONDUCT.md contribution and code of conduct (#1) 2023-11-29 12:54:28 -08:00
CONTRIBUTING.md Readme (#2) 2023-11-29 16:23:42 -08:00
LICENSE copyright + ack 2023-11-30 11:12:53 -08:00
MANIFEST.in awni's commit files 2023-11-29 10:30:41 -08:00
mlx.pc.in awni's commit files 2023-11-29 10:30:41 -08:00
pyproject.toml jagrit's commit files 2023-11-29 10:52:08 -08:00
README.md Added stubs for python files generated from C++ (#136) 2023-12-14 12:58:45 -08:00
setup.py Added stubs for python files generated from C++ (#136) 2023-12-14 12:58:45 -08:00

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 a fully featured C++ API, which closely mirrors 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 the Python API, run:

pip install mlx

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.

Optional: Generate stubs for C++ python objects to enable IDE auto-completion

pip install ".[dev]"
python setup.py generate_stubs