Logging project-level metadata

Project metadata helps you maintain a single source of truth for runs and models tracked in the project.

In each project, there is a Project metadata tab. You can log metadata to this section by initializing a project object with your project name.

Example

For an example project ml-team/classification:

project = neptune.init_project(
    project="ml-team/classification",
)

You can now log metadata to the project object as you normally would.

project["general/brief"] = URL_TO_PROJECT_BRIEF
project["general/data_analysis"].upload("data_analysis.ipynb")

project["dataset/latest"].track_files("s3://datasets/images")

Then, if you start a run, you can fetch and use already tracked metadata from the project:

run = neptune.init_run()
run["dataset"] = project["dataset/latest"].fetch()

Note on collaboration

The project object follows the same logic as other Neptune objects: If you assign a new value to an existing field, the new value overwrites the previous one.

In a given project, you always initialize and work with the same project object, so take care not to accidentally override each other's entries if your team is collaborating on project metadata.

Tip: Recall that the append() method appends the logged value to a series. It works for text strings as well as numerical values.