Python interoperability

Not only does Mojo use a Pythonic syntax, our plan is to provide full compatibility with the Python ecosystem. There are two types of compatibility (or interoperability) that we support:

• Calling Python from Mojo:

  You can import existing Python modules and use them in a Mojo program. This is 100% compatible because we use the CPython runtime without modification for full compatibility with existing Python libraries. You can construct Python objects and call Python functions directly from Mojo, using the CPython interpreter as a dynamic library (shown as libpython.dylib in figure 1).

• Calling Mojo from Python:

  You can extend your Python code with high-performance Mojo code (or incrementally migrate Python code to Mojo). Because Mojo is a compiled language, we can't directly "evaluate" Mojo code from Python. Instead, you must declare which Mojo functions and types are available to be called from Python (declare the "bindings"), and then you can import them in your Python code (shown as mojo_module in figure 1) just like any other module—there's no extra compilation step.

Figure 1. A simplified look at how a Mojo program calls into Python and a Python program calls into a Mojo module.

By embracing both directions of language interop, you can choose how to use Mojo with Python in a way that works best for your use case.

To learn more about bridging Python ↔ Mojo, continue reading:

Was this page helpful?

Thank you! We'll create more content like this.

Thank you for helping us improve!

😔 What went wrong?

Some code doesn’t work

It includes inaccurate information

It's missing information I need

It was difficult to understand

Other

Submit