Add tags

Tags make it easier to identify and organize your runs and models. You can add tags either at creation, or later via the API or web app.

(Runs) Adding tags at initialization

Pass a list of tags to the tags argument at initialization:

import neptune

run = neptune.init_run(tags=["maskRCNN", "finetune", "prod_v2.0.1"])

Adding tags later

Tags are stored in the sys/tags field, which is of the type StringSet. Use the add() method to add entries:

run["sys/tags"].add(["maskRCNN", "prod_v2.0.1"])
run["sys/tags"].add("finetune") # (1)!

1. Adds finetune to the list of tags.

Adding tags to a model version

model_version = neptune.init_model_version(model="NLI-PRETRAINED")
model_version["sys/tags"].add(["finetune", "prod_v2.0.3"])

Tip

You can also include emoji in tags:

run["sys/tags"].add("best 🏆")

Managing tags in the web app

In the table view, click inside the Tags column to edit the tags.

To edit tags in bulk, select multiple runs or models and click Manage tags in the upper right.

Related

When fetching the runs table, you can filter the results by tag. You can also fetch the tags of a run or other object as a list.

For details, see Query metadata from Neptune.