Nuke as a Python Module

You can import Nuke as a module into a third-party Python 2.7.16 interpreter, granting full access to the Nuke Python-API, but from within a native Python interpreter instead of Nuke.

Note: Foundry cannot provide customer support for third-party Python interpreters.

To run Nuke as a Python module:

Add the file path for Nuke's site-packages directory to the usrlocal.pth file in your Python 2.7.16 install.

For example, if you're running on Windows, add C:\Program Files\Nuke 12.0v8\lib\site-packages to the usrlocal.pth file.

Tip: You can also use relative paths to the directory containing the usrlocal.pth file.

At the Python prompt, use the import nuke declaration to make Nuke’s Script Editor functions and commands (such as nuke.nodes.Blur() to add a Blur node) available in your chosen Python interpreter.

The import nuke function checks-out a nuke_r render license by default. If you want to use Nuke interactively, and you have a nuke_i license, set the NUKE_INTERACTIVE environment variable to 1.

See Environment Variables for more information on setting environment variables.

For more information on using Nuke as a Python module, select Help > Documentation from Nuke's menu bar and navigate to Python Developers Guide > Nuke as a Python Module.

Did you find this helpful?

Yes No

Sorry you didn't find this helpful

Why wasn't this helpful? (check all that apply)

Couldn't find what I was looking for

Instructions are confusing

Instructions didn't work

Title is misleading

Content is out-of-date

The translation is poor

Thanks for your feedback.

If you can't find what you're looking for or you have a workflow question, please try Foundry Support.

If you have any thoughts on how we can improve our learning content, please email the Documentation team using the button below.

That's great!

Thanks for taking time to give us feedback.