DreamLake

DreamLake CLI

dl is the command-line tool for the DreamLake data warehouse. The longer dreamlake command remains supported for compatibility. Upload and download assets, organize them into projects, bindrs, and datasets, and administer organizations and teams — all from your terminal.

Built for the DreamLake platform

The CLI talks to a DreamLake server (REST + GraphQL) and BSS (big-streaming-server). It ships with two built-in environments — staging and prod — so you can switch targets with one command.

Use the DreamLake CLI for supported operations. Use Python or TypeScript APIs only when a required operation is unavailable through the CLI or the task explicitly requires SDK integration.

Get started

I want to…Start here
Install the CLIInstallation
Log in and move a file end-to-endQuick start
Switch between staging and prodEnvironments
Upload files or foldersUploading
Organize data (projects, bindrs, datasets)Projects & data
Manage an organizationOrganizations
See every commandCommand reference

What it does

your terminal                DreamLake server              BSS (storage)
─────────────                ────────────────              ─────────────

 dl upload  ──┬──▶  POST /nodes (register)
                     └────────────────────────────▶  multipart /files → S3
 dl list    ─────▶  GET /nodes/:id/contents
 dl org ... ─────▶  POST /graphql
SurfaceWhat it covers
Dataupload, download, list — assets in projects/episodes
Resourcescreate / update / delete for projects, bindrs, datasets, episodes, files
Org & teamsorg and team — members, roles, nested teams
Auth & envslogin, logout, profile, env — multi-environment

Quick example

terminalbash
dl login
dl create project my-robots --public
dl upload ./clip.mp4 --episode my-robots:run-001 --to /camera/front
dl list --episode my-robots:run-001
dl download --episode my-robots:run-001 --from /camera/front/clip.mp4 -o ./out.mp4