EpistaBase Docs
SDK

Assets, files, and queries

Discover catalog assets, open governed files, and query workspace tables.

guideReviewed 2026-06-26

Use catalog assets to discover data visible to your scoped token.

import biolake as bl

assets = bl.assets(limit=100)
flow_assets = bl.assets(kind="FLOW")
experiment_assets = bl.assets(experiment="EXP-2026-0001")

Get one asset

asset = bl.get(assets[0].id)
asset.name
asset.format
asset.lineage

Asset objects describe governed data. They are not storage credentials.

Open whole-blob files

Use bl.open() for raw blobs such as FCS files, CSV/XLSX files, and vendor exports.

with bl.open(asset.id) as reader:
    header = reader.read(64)

When a library requires a local path:

with bl.open(asset.id, download=True) as path:
    parse_vendor_file(path)

Use image reads for tiled or pyramidal image assets.

Query tables

table = bl.query("select * from current_table limit 10")
df = table.to_pandas()                 # the result is materialized in memory
tables = bl.list_tables()
current = bl.current_table()

Query results are governed by the active workspace and API authorization. The query path is useful for notebooks because successful SDK queries can become part of figure lineage when you publish an output.

On this page