Function Compiler

Function compiles stateless Python functions to run natively cross-platform. This project is a playground for testing Function's compiler. Over time, we expect to open-source more and more of the compiler infrastructure in this project.

Setup Instructions

First, install Function for Python:

# Install Function for Python
$ pip install --upgrade fxn

Next, head over to the Function dashboard to generate an access key. Once generated, sign in to the CLI:

# Sign in to the Function CLI
$ fxn auth login <ACCESS KEY>

Compiling a Function

The predictors directory contains several prediction functions, ranging from very simple functions to AI inference with PyTorch. Internally, we use these functions to test language and library coverage in the compiler. To compile a function, first update the predictor tag with your Function username:

@compile(
    tag="@username/some-function", # replace `username` with your Function username
    description="Compile a cool function."
)
def grader (score: float) -> str:
    ...

Next, use the Function CLI to compile the function, providing the path to the module where the function is defined:

# Compile the decorated function at the module path
$ fxn compile path/to/module.py

The compiler will load the entrypoint function, create a remote sandbox, and compile the function:

Inspecting the Generated Code

Developers with source code access can download and inspect the generated native code. Because our compiler can generate many different native implementations for a given predictor, developers can retrieve the native code for a specific prediction using the prediction identifier:

# Retrieve the source code for a given prediction
$ python3 tools/source.py       \
  --prediction <prediction id>  \
  --access-key <access key>

Note

You must have source code access to retrieve generated code. If you would like to request source code access, reach out to us.

Warning

The generated code is provided for reference and cannot be compiled independently, as it depends on additional scaffolding provided by the Function compiler toolchain.

Useful Links

• Discover predictors to use in your apps.
• Join our Discord community.
• Check out our docs.
• Learn more about us on our blog.
• Reach out to us at stdin@fxn.ai.

Function is a product of NatML Inc.