Synphony CLI

Command line interface for the Synphony robotics data platform.

Installation

pip install synphony-cli

Or with pipx (recommended):

pipx install synphony-cli

Quick Start

1. Get your API token from synphony.co/settings

2. Authenticate:

synphony auth <your-token>

3. Initialize a project:

# Link to existing dataset
synphony init "My Dataset"

# Or create a new dataset
synphony init --new
synphony init --new "My New Dataset"

4. Process videos (uploads and generates augmented data):

synphony multiply *.mp4 -p "change lighting" -p "add motion blur"

5. Check status:

synphony status

6. Download results:

synphony pull

Commands

Augmentations

Apply traditional computer vision augmentations (faster than AI generation):

# Simple - use default parameters
synphony augment *.mp4 --flip --rotation --jitter

# With custom parameters
synphony augment *.mp4 --rotation degrees=30,p=0.8 --jitter brightness=1.5

# Apply all augmentations
synphony augment *.mp4 --all

# Use a config file for full control
synphony augment *.mp4 --config augs.json

Available augmentations:

• --flip - Horizontal flip
• --rotation - Random rotation (degrees, p, resample)
• --affine - Affine transformation (degrees, p)
• --perspective - Perspective warp (distortion_scale, p)
• --crop - Random resized crop (size, p)
• --noise - Gaussian noise (mean, std, p)
• --jitter - Color jitter (brightness, contrast, p)
• --erasing - Random erasing/occlusion (p)

Example augs.json:

[
  {"name": "RandomRotation", "params": {"degrees": 30, "p": 0.8}},
  {"name": "ColorJitter", "params": {"brightness": 1.5, "contrast": 1.2}}
]

Links

• Website
• Documentation