Skip to main content

​
Storage Commands

Upload, download, list, and delete files in your Lyceum cloud storage.

​
Commands

CommandDescription
lyceum storage lsList files in cloud storage
lyceum storage loadUpload a file or directory
lyceum storage downloadDownload a file
lyceum storage rmDelete a file
lyceum storage rmdirDelete all files in a folder

​
lyceum storage ls

List files in your cloud storage. 
lyceum storage ls [prefix]

​
Arguments

ArgumentDescription
prefixFolder prefix to list (e.g., data/ or models/). Default: root

​
Options

OptionDescription
--max, -nMaximum number of files to fetch. Default: 1000
--recursive, -rList all files recursively

​
Examples

# List root directory
lyceum storage ls

# List a specific folder
lyceum storage ls data/

# List all files recursively
lyceum storage ls data/ --recursive

# Limit results
lyceum storage ls --max 50

​
lyceum storage load

Upload a file or directory to your cloud storage. 
lyceum storage load <local_path>

​
Arguments

ArgumentDescription
local_path(required) Local file or directory path to upload

​
Options

OptionDescription
--key, -kRemote path/key (defaults to filename or directory name)
--recursive, -rUpload directory recursively
--force, -fSkip confirmation for directory uploads

​
Examples

# Upload a single file
lyceum storage load ./data.csv

# Upload with a custom remote path
lyceum storage load ./model.pt --key models/my-model.pt

# Upload a directory recursively
lyceum storage load ./my-folder --recursive

# Upload to a specific remote path
lyceum storage load ./data -r --key datasets/

# Skip confirmation prompt
lyceum storage load ./data -rf

​
lyceum storage download

Download a file from your cloud storage. 
lyceum storage download <remote_path>

​
Arguments

ArgumentDescription
remote_path(required) Remote file path/key to download

​
Options

OptionDescription
--output, -oLocal output path (defaults to filename)

​
Examples

# Download a file
lyceum storage download data.csv

# Download to a specific local path
lyceum storage download models/my-model.pt --output ./local-model.pt

# Download with short option
lyceum storage download configs/prod.json -o ./config.json

​
lyceum storage rm

Delete a file from your cloud storage. 
lyceum storage rm <remote_path>

​
Arguments

ArgumentDescription
remote_path(required) Remote file path/key to delete

​
Options

OptionDescription
--force, -fSkip confirmation

​
Examples

# Delete a file (with confirmation)
lyceum storage rm data.csv

# Delete without confirmation
lyceum storage rm models/old-model.pt --force

​
lyceum storage rmdir

Delete all files in a folder. 
lyceum storage rmdir <folder_path>

​
Arguments

ArgumentDescription
folder_path(required) Folder prefix to delete (e.g., old-data/)

​
Options

OptionDescription
--force, -fSkip confirmation

​
Examples

# Delete a folder (with confirmation)
lyceum storage rmdir old-data/

# Delete without confirmation
lyceum storage rmdir temp/ --force

​
Using Storage with Executions

Files in your cloud storage are accessible during code execution. See the Storage documentation for details on accessing files in your Python code.