Skip to content

Registering a model#

For each model that you're working with, you can create a model object in Neptune and track any related metadata.

The Model object is suitable for storing general metadata that is shared by all versions of the model – for example, the model signature and validation datasets.

  1. In the Models tab, click Create new model.
  2. Enter a key and optionally a name and description for your model.
  3. To log metadata to the model, initialize it in your code:

    import neptune
    model = neptune.init_model(
        model="CLS-PRE",  # Your model ID here
    How do I find the ID?

    The Neptune ID is a unique identifier for the object. It's shown in the leftmost column of the table view.

    The ID is stored in the system namespace, in the "sys/id" field.

Import Neptune and initialize a Model object:

import neptune

model = neptune.init_model(
    name="A name for your model",  # optional
    key="MODEL_KEY",  # must be uppercase and unique within the project

To see the model in Neptune, navigate to the Models tab.

Logging metadata to the model#

Track model metadata by assigning them to the model object:

model_info = {"size_limit": 50.0, "size_units": "MB"}
model["model"] = model_info

Upload the model signature and other data with the upload() method:


Track dataset versions with the track_files() method:


To stop the connection to Neptune and sync all data, call the stop() method and execute the script or cell:


To see the model in Neptune, click the link in the console output.

Next steps#