This is an updated git repository of all the tools found on my website. It's provided as an alternative to downloading tools individually, if you want to stay up to date with everything.
Feel free to fork or contribute.
Download the most current release or clone the repository to a directory of your choice.
Setting the environment variable MAYA_MODULE_PATH is the easiest way to integrate the tools into Maya. You can put the path to ml_tools either in the Maya.env file or set a system environment path prior to launching Maya via shell.
In the further examples, we will use /path/to/ml_tools as a path example. You have to replace it by the path you use.
set "MAYA_MODULE_PATH=%MAYA_MODULE_PATH%;/path/to/ml_tools"
export MAYA_MODULE_PATH=$MAYA_MODULE_PATH:/path/to/ml_tools
You will need to edit the Maya.env located in your /maya/version folder. Where is it and how to open it on the Autodesk manual.
Once Maya.env opened, add the following at the end of the file:
MAYA_MODULE_PATH = /path/to/ml_tools
In the shelf, click the gear icon on the left side, then Load Shelf:
Tests run inside Maya via mayapy (not from system Python). Ensure ml_tools is on MAYA_MODULE_PATH so scripts/ resolves the same way as in Maya.
Install dev dependencies into Maya's Python (once per Maya install):
"C:\Program Files\Autodesk\Maya2024\bin\mayapy.exe" -m pip install -r requirements-dev.txt
Run the full suite:
"C:\Program Files\Autodesk\Maya2024\bin\mayapy.exe" -m pytest tests/ -v
Exclude UI entry-point smoke tests:
mayapy -m pytest tests/ -v -m "not ui"
Note: mayapy runs in batch mode, so Maya UI commands are unavailable. Entry-point smoke for ui() tools is skipped automatically; logic tests call underlying functions directly. Run UI smoke interactively from Maya's Script Editor if needed.
ml_dynamics (secondary motion / XPBD simulation) has moved to the standalone anim_dynamics repository. Install both repos on MAYA_MODULE_PATH if you use dynamics alongside other ml_tools scripts. See G:\My Drive\packages\anim_dynamics\README.md for install and test instructions.