Sandbox — LSD is in active testing. All systems operational·payments are test-mode (no real charges).
Overview Use Cases News Docs Tool Store Support Community Get LSD
All docs
Engine· classmethod

Engine.load

opens a saved project and returns an engine

Python
Engine.load(path, *, event_bus=None, workspace=None) -> Engine

Returns Engine — the restored engine, with entities and cached outputs reattached

Parameters#

name type default description
path str the .lsd file (or JSON) written by save
event_bus EventBus | None None bus to attach; a fresh one is created when omitted
workspace str | None None override the stored workspace path

Example#

Python
from lsdtools import Engine

engine = Engine.load("survey.lsd")
engine.run_all(resume=True)

Notes#

Loads the project's declared packages first, so every step/entity class is registered before deserialization. Reattaches persisted step outputs, so cached results are reused without re-running. The workspace override lets a host define a project by where its .lsd file lives (portable, and sibling projects in one folder share input data).

See also#

API: save · ephemeral · run_all

By LSD Team · Last updated Jul 17, 2026 Ask on Discord View as Markdown