Getting Started

1. Authenticate

bash

dreamlake login --url http://localhost:10334

Opens your browser for OAuth device auth. On headless machines, add --no-browser for a QR code.

2. Upload

bash

dreamlake upload ./run01.mp4 \
  --episode alice@robotics:run-042 \
  --to /camera/front

File type is auto-detected from extension. Large files are chunked (10 MB parts, 4 parallel workers) and uploaded via S3 multipart.

Extension	Type
`.mp4`, `.mov`, `.mkv`, `.webm`	video
`.wav`, `.mp3`, `.flac`, `.aac`	audio
`.vtt`, `.srt`	text-track
`.jsonl`, `.csv`	label-track

3. List & Download

bash

dreamlake list --episode alice@robotics:run-042
dreamlake download --episode alice@robotics:run-042 --from /camera/front -o ./video.mp4

4. Organize with Bindrs

bash

dreamlake create bindr "front-camera" --project robotics@alice --episode "2026/04/*"
dreamlake create dataset "training-v1" --project robotics@alice
dreamlake update dataset "training-v1" --project robotics@alice --add "front-*"

Episode Syntax

The --episode flag uses [namespace@]project[:episode]:

Example	Namespace	Project	Episode
`robotics`	(current user)	`robotics`	—
`alice@robotics`	`alice`	`robotics`	—
`alice@robotics:run-042`	`alice`	`robotics`	`run-042`

Environment Variables

Variable	Description
`DREAMLAKE_REMOTE`	Server URL
`DREAMLAKE_BSS_URL`	BSS URL
`DREAMLAKE_API_KEY`	API token (skip login)