The MAX Platform (includes Mojo)
Welcome to MAX
Note: Mojo is included as a subdirectory in this repository
The Modular Accelerated Xecution (MAX) platform is an integrated suite of AI libraries, tools, and technologies that unifies commonly fragmented AI deployment workflows. MAX accelerates time to market for the latest innovations by giving AI developers a single toolchain that unlocks full programmability, unparalleled performance, and seamless hardware portability.
See here to get started with MAX and when you want to report issues or request features, please create a GitHub issue here.
The Discord community and our forum is the best place to share your experiences and chat with the team and other community members.
In the examples directory, you will find code examples and Jupyter notebooks that show how to run inference with MAX.
Getting Started
MAX is available in both stable and nightly builds. To install either version, follow the guide to create a project with Magic.
Then clone this repository:
git clone https://github.com/modular/max.git
If you installed the stable build (v24.6), be sure you switch to the stable branch,
because the main branch is for nightly releases and might not be compatible
with stable builds:
git checkout stable
Running
MAX Pipelines
To show off the full power of MAX, a series of end-to-end pipelines for common AI workloads (and more) are ready to run. As one example, this includes everything needed to self-host the Llama 3.1 text-generation model. All code is provided so that these pipelines can be customized, built upon, or learned from.
Examples
In addition to the end-to-end pipelines, there are many examples that exercise various aspects of MAX. You can follow the instructions in the README for each example or notebook you want to run.
Notebooks
Check out the notebooks examples for using MAX Engine 🏎️ for models such as
Tutorials
The tutorials directory contains the "finished" code for tutorials you can read at docs.modular.com/max/tutorials.
Docker Container
The MAX container is our official Docker container for convenient MAX deployment. It includes the latest MAX version with GPU support, several AI libraries, and integrates with orchestration tools like Kubernetes.
The MAX container image is available in the Modular Docker Hub repository.
Contributing
Thanks for your interest in contributing to this repository!
We accept contributions to the Mojo standard library. Please see the Contribution Guide for instructions.
We are not accepting contributions for other parts of the repository.
We also welcome your bug reports. If you have a bug, please file an issue here.
If you need support, the Discord community and our forum is the best place to share your experiences and chat with the team and other community members.
License
This repository and its contributions are licensed under the Apache License v2.0 with LLVM Exceptions (see the LLVM License). MAX and Mojo usage and distribution are licensed under the MAX & Mojo Community License.
Third Party Licenses
You are entirely responsible for checking and validating the licenses of third parties (i.e. Huggingface) for related software and libraries that are downloaded.