AL_omx

AL_omx is an open-source library that provides a thin wrapper around Maya OM2 which makes it easy to manipulate nodes, attributes and connections while retaining the API's performance:

• User-friendly entry point into Maya’s native om2 (maya.api.OpenMaya) API .
• Simple explicit code. Cookbook.
• Closer to Maya’s om2 API’s performance over other libraries. Performance Comparison.
• Built-in Undoability.

QuickStart

Install AL_omx using mayapy -m pip install AL_omx, or by adding the root directory to sys.path. The url for PyPi package is here.

For more information on the installation, check out here.

The requirements of AL_omx:

Syntax

AL_omx uses object-oriented syntax:

    from AL import omx

    transform, locator = omx.createDagNode(
        "locator", nodeName="myLocShape", returnAllCreated=True
    )
    omx.createDGNode("time", nodeName="myTime")
    persp = omx.XNode("persp")
    perspShape = omx.XNode("perspShape")

    persp.visibility.setLocked(True)
    transform.t.set([2.0, 2.0, 2.0])
    print(f"locator worldMatrix: {transform.wm[0].get()}")
    locator.overrideEnabled.set(True)
    locator.overrideColor.set(14)

    persp.r.connectTo(transform.r)
    transform.sx.connectFrom(omx.XNode("time1").outTime)
    transform.r.disconnectFromSource()

    # ctrl+Z/shift+Z to undo & redo

Documentation

The full document source is available in the docs folder, you can generate the document yourself using sphinx, check out here for how to do it.

The full online documentation can be found at https://animallogic.github.io/AL_omx/

Here are some convenient entries:

• Cookbook Style Snippets
• Public API Reference
• Running Tests
• Changes Log

Contribution & Feedback

For how to contribute to AL_omx, check out here. If you have any issues or feature suggestions, please feel free to submit a ticket in GitHub Issues.

Update on Project Governance and Contributions

As of May 11 2026, the AL_omx project is updating its contribution process.

What is Changing?

Retirement of Formal CLAs: We no longer require contributors to sign and email a PDF of the Individual or Corporate Contributor License Agreement. By submitting a contribution to this project, you represent that you are entitled to grant the relevant licenses for your contribution. All contributions are now governed strictly by the Apache License, Version 2.0 included in this repository. If you or your corporation have already signed a CLA for the AL_omx project, those agreements remain on file as a historical record of the intellectual property permissions granted for previous versions of the software.