Sync artifacts from a local instance to a cloud instance 
¶
import lamindb as ln
ln.connect("laminlabs/lamin-dev")
→ connected lamindb: testuser1/test-sync-to-cloud
! re-setting django: avoid this by clearing the default instance on the command line via: lamin disconnect
→ connected lamindb: laminlabs/lamin-dev
Show code cell content
def cleanup(artifact: ln.Artifact):
features_sets = artifact.schemas.all()
compounds = artifact.compounds.all()
artifact.delete(permanent=True, storage=False)
features_sets.delete()
compounds.delete()
artifacts = ln.Artifact.filter(description="test-sync-to-cloud")
for artifact in artifacts:
cleanup(artifact)
→ a file/folder remains here: /home/runner/work/lamindb/lamindb/docs/storage/test-sync-to-cloud/.lamindb/rgvAn4i7vbl4meVF0000.parquet
! moved records to trash (branch_id = -1)
! moved records to trash (branch_id = -1)
artifact = ln.Artifact.connect("testuser1/test-sync-to-cloud").get(
description="test-sync-to-cloud"
)
artifact.describe()
Artifact: (0000) | description: test-sync-to-cloud ├── uid: 5ZAlJWA5uAuQ4lW60000 run: │ kind: dataset otype: DataFrame │ hash: 7L2QcOI8XJdkWHCN_8OZNg size: 1.6 KB │ branch: main space: all │ created_at: 2026-06-23 06:39:34 UTC created_by: testuser1 │ n_observations: 3 ├── storage/path: │ /home/runner/work/lamindb/lamindb/docs/storage/test-sync-to-cloud/.lamindb/5ZAlJWA5uAuQ4lW60000.parquet ├── Dataset features │ └── var (2 bionty.CellMarker) │ CD21 num │ PD1 num └── Labels └── .compounds pertdb.Compound compound-test-sync-to-cloud .organisms bionty.Organism human
artifact.save(transfer="annotations")
! no run & transform got linked, call `ln.track()` & re-run
→ returning schema with same hash: Schema(uid='hvnEPOmd6hIq0VRd', is_type=False, name=None, description=None, n_members=2, coerce=None, flexible=False, itype='bionty.CellMarker', otype=None, hash='cUhsAI-g_fRwslfyvt3e7w', minimal_set=True, ordered_set=False, maximal_set=False, branch_id=1, created_on_id=1, space_id=1, created_by_id=2, run_id=None, type_id=None, created_at=2026-01-10 17:38:21 UTC, is_locked=False)
→ mapped: Compound(uid='2FyQIklIJ3dm1n'), Organism(uid='1dpCL6TduFJ3AP')
→ transferred: Artifact(uid='5ZAlJWA5uAuQ4lW60000')
Artifact(uid='5ZAlJWA5uAuQ4lW60000', key=None, description='test-sync-to-cloud', suffix='.parquet', kind='dataset', otype='DataFrame', size=1610, hash='7L2QcOI8XJdkWHCN_8OZNg', n_files=None, n_observations=3, extra_data=None, branch_id=1, created_on_id=1, space_id=1, storage_id=1957, run_id=6144, schema_id=None, created_by_id=2, created_at=2026-06-23 06:39:34 UTC, is_locked=False, version_tag=None, is_latest=True)
artifact.describe()
Artifact: (0000) | description: test-sync-to-cloud ├── uid: 5ZAlJWA5uAuQ4lW60000 run: 0ItaTcJ (__lamindb_transfer__/4oq8uvYI1NwH) │ kind: dataset otype: DataFrame │ hash: 7L2QcOI8XJdkWHCN_8OZNg size: 1.6 KB │ branch: main space: all │ created_at: 2026-06-23 06:39:34 UTC created_by: testuser1 │ n_observations: 3 ├── storage/path: │ /home/runner/work/lamindb/lamindb/docs/storage/test-sync-to-cloud/.lamindb/5ZAlJWA5uAuQ4lW60000.parquet ├── Dataset features │ └── var (2 bionty.CellMarker) │ CD21 num │ PD1 num └── Labels └── .compounds pertdb.Compound compound-test-sync-to-cloud .organisms bionty.Organism human
assert artifact._state.db == "default"
assert artifact.organisms.get().name == "human"
assert artifact.compounds.get().name == "compound-test-sync-to-cloud"
assert artifact.features.slots["var"].members.count() == 2
Show code cell content
!rm -r ./test-sync-to-cloud
!lamin delete --force test-sync-to-cloud