Using external Python libraries with Maya Python

If you want to use libraries external to Maya in your Python scripts, you will have to add them either to your PYTHONPATH environment variable before you start Maya, or add them to the system path by calling sys.path.append() from within your Python interpreter.

You can either add the libraries to your PYTHONPATH environment variable within your Maya.env file or set the variable in your environment before starting Maya.

The Maya.env file is located in C:\Users\<Username>\Documents\maya\<version_number>\ on Windows, $HOME/maya/<version_number>/ on Linux, and $HOME/Library/Preferences/Autodesk/maya/<version_number>/ on macOS.

For more information on PYTHONPATH, see File path variables.

To add libraries to the Python system path from within the Python interpreter, use sys.path.append()

import sys sys.path.append( '<Path_To_Libraries>' )

You can also add the call to sys.path.append() in a start up script such as userSetup.py.