lamindb.track

lamindb.track(transform=None, *, project=None, space=None, branch=None, features=None, params=None, new_run=None, path=None, pypackages=None)

Track a run of your notebook or script.

Populates the global run context by managing Transform & Run records and caching the compute environment.

If sync_git_repo is set, checks whether a script-like transform exists in a git repository and links it.

Parameters:

  • transform (str | Transform | None, default: None) – A transform (stem) uid (or record). If None, auto-creates a transform with its uid.

  • project (str | Project | None, default: None) – A project (or its name or uid) for labeling entities.

  • space (str | Space | None, default: None) – A restricted space (or its name or uid) in which to store entities. Default: the "all" space. Note that bionty entities ignore this setting and always get written to the "all" space. If you want to manually move entities to a different space, set the .space field (Manage access).

  • branch (str | Branch | None, default: None) – A branch (or its name or uid) on which to store records.

  • features (dict | None, default: None) – A dictionary of features & values to track for the run.

  • params (dict | None, default: None) – A dictionary of params & values to track for the run.

  • new_run (bool | None, default: None) – If False, loads the latest run of transform (default notebook), if True, creates new run (default non-notebook).

  • path (str | None, default: None) – Filepath of notebook or script. Only needed if it can’t be automatically detected.

  • pypackages (bool | None, default: None) – If True or None, infers Python packages used in a notebook.

Return type:

None

Examples

To track the run of a notebook or script, call:

ln.track()
#> → created Transform('Onv04I53OgtT0000'), started new Run('dpSfd7Ds...') at 2025-04-25 11:00:03 UTC
#> • recommendation: to identify the notebook across renames, pass the uid: ln.track("Onv04I53OgtT")

Ensure one version history across file renames:

ln.track("Onv04I53OgtT")
#> → created Transform('Onv04I53OgtT0000'), started new Run('dpSfd7Ds...') at 2025-04-25 11:00:03 UTC

More examples: Track notebooks, scripts & functions