Can I disable tracking run inputs? 
¶
Yes, if you switch track_run_inputs to False.
lamin init --storage test-run-inputs
Show code cell output
→ initialized lamindb testuser1/test-run-inputs in /home/runner/work/lamindb/lamindb/docs
/faq
import lamindb as ln
Show code cell output
→ connected lamindb: testuser1/test-run-inputs
Some test artifacts:
ln.track(transform=ln.Transform(key="Dummpy pipeline"))
ln.Artifact(ln.examples.datasets.file_jpg_paradisi05(), description="My image").save()
ln.Artifact(ln.examples.datasets.file_mini_csv(), description="My csv").save()
Show code cell output
→ created Transform('DbU8qAnQp0n70000', key='Dummpy pipeline'), started new Run('Dqe8hkJcJ4isC0XX') at 2026-09-30 06:12:51 UTC
! data is a DataFrame, please use .from_dataframe()
Artifact(uid='5HhRSTcxZqH2n1RS0000', key=None, description='My csv', suffix='.csv', kind=None, otype='DataFrame', size=11, hash='z1LdF2qN4cN0M2sXrcW8aw', n_files=None, n_observations=None, extra_data=None, branch_id=1, created_on_id=1, space_id=1, storage_id=1, run_id=1, schema_id=None, created_by_id=1, created_at=2026-09-30 06:12:53 UTC, is_locked=False, version_tag=None, is_latest=True)
Call ln.track():
ln.track("Rx2s9aPTMQLY0000")
Show code cell output
→ created Transform('Rx2s9aPTMQLY0000', key='track-run-inputs.ipynb'), started new Run('el8uuhteeV4R52kR') at 2026-09-30 06:12:53 UTC
→ notebook imports: lamindb
Don’t track artifact as run input¶
ln.settings.track_run_inputs = False
artifact = ln.Artifact.get(description="My image")
artifact.cache()
Show code cell output
PosixUPath('/home/runner/work/lamindb/lamindb/docs/faq/test-run-inputs/.lamindb/rIYIBvRGwTcdC7Ef0000.jpg')
No run inputs are linked to the current notebook run:
ln.Run.get(id=ln.context.run.id).input_artifacts.all()
Show code cell output
<ArtifactBasicQuerySet []>
artifact.view_lineage()
Show code cell output
assert len(ln.Run.get(id=ln.context.run.id).input_artifacts.all()) == 0
Manually track artifact as run input¶
Let us manually track an artifact by passing is_run_input to either .cache(), .load() or .open():
artifact.cache(is_run_input=True)
Show code cell output
PosixUPath('/home/runner/work/lamindb/lamindb/docs/faq/test-run-inputs/.lamindb/rIYIBvRGwTcdC7Ef0000.jpg')
You can see the fcs artifact is now being added to the run inputs:
for input in ln.Run.get(id=ln.context.run.id).input_artifacts.all():
print(input)
Show code cell output
Artifact(uid='rIYIBvRGwTcdC7Ef0000', key=None, description='My image', suffix='.jpg', kind=None, otype=None, size=29358, hash='r4tnqmKI_SjrkdLzpuWp4g', n_files=None, n_observations=None, extra_data=None, branch_id=1, created_on_id=1, space_id=1, storage_id=1, run_id=1, schema_id=None, created_by_id=1, created_at=2026-09-30 06:12:53 UTC, is_locked=False, version_tag=None, is_latest=True)
artifact.view_lineage()
Show code cell output
assert len(ln.Run.get(id=ln.context.run.id).input_artifacts.all()) == 1
Automatically track artifacts as run input¶
If you switch the following setting, and call to .load(), .cache() and .open() will track the artifact as run input.
ln.settings.track_run_inputs = True
artifact = ln.Artifact.get(description="My csv")
artifact.load()
Show code cell output
| test | |
|---|---|
| 0 | 1 |
| 1 | 2 |
| 2 | 3 |
for input in ln.Run.get(id=ln.context.run.id).input_artifacts.all():
print(input)
Show code cell output
Artifact(uid='rIYIBvRGwTcdC7Ef0000', key=None, description='My image', suffix='.jpg', kind=None, otype=None, size=29358, hash='r4tnqmKI_SjrkdLzpuWp4g', n_files=None, n_observations=None, extra_data=None, branch_id=1, created_on_id=1, space_id=1, storage_id=1, run_id=1, schema_id=None, created_by_id=1, created_at=2026-09-30 06:12:53 UTC, is_locked=False, version_tag=None, is_latest=True)
Artifact(uid='5HhRSTcxZqH2n1RS0000', key=None, description='My csv', suffix='.csv', kind=None, otype='DataFrame', size=11, hash='z1LdF2qN4cN0M2sXrcW8aw', n_files=None, n_observations=None, extra_data=None, branch_id=1, created_on_id=1, space_id=1, storage_id=1, run_id=1, schema_id=None, created_by_id=1, created_at=2026-09-30 06:12:53 UTC, is_locked=False, version_tag=None, is_latest=True)
artifact.view_lineage()
Show code cell output
assert len(ln.Run.get(id=ln.context.run.id).input_artifacts.all()) == 2