Rendered.ai Synthetic Data Studio CLI

A fast, minimal-dependency CLI for managing synthetic datasets, graphs, channels, workspaces, volumes, and more on the Rendered.ai Synthetic Data Studio platform.

Claude Code | Gemini CLI | Codex | CLI Only | CLI Usage

The rai-sds skill uses the Agent Skills open standard and works across Claude Code, Google Gemini CLI, and OpenAI Codex.

Plugin (recommended — auto-installs binary + skill):

# 1. Add the marketplace (one time)
/plugin marketplace add https://github.com/renderedai/rai-synthetic-data-studio-cli

# 2. Install the plugin
/plugin install rai-sds

Or use /plugin and follow the interactive menu.

This installs the rai-sds plugin, which:

• Adds the /rai-sds:rai-sds skill to Claude Code
• Adds the /rai-sds:setup command for guided onboarding

After installing, reload plugins to activate the new commands (no restart needed):

/reload-plugins

Then run /setup to get started:

/rai-sds:setup

This will check if you're logged in, walk you through authentication (or registration), and help you set your organization and workspace context.

Standalone skill (skill only):

curl -fsSL https://raw.githubusercontent.com/renderedai/rai-synthetic-data-studio-cli/main/install-skill.sh | bash

Installs the binary and skill to ~/.claude/skills/rai-sds/. Run /reload-plugins to activate /rai-sds without restarting.

Extension (recommended — includes context file + skill):

gemini extensions install https://github.com/renderedai/rai-synthetic-data-studio-cli

Standalone skill (skill only):

curl -fsSL https://raw.githubusercontent.com/renderedai/rai-synthetic-data-studio-cli/main/install-gemini-skill.sh | bash

Installs the binary and skill to ~/.gemini/skills/rai-sds/. Restart Gemini CLI to activate.

curl -fsSL https://raw.githubusercontent.com/renderedai/rai-synthetic-data-studio-cli/main/install-codex-skill.sh | bash

Installs the binary and skill to ~/.codex/skills/rai-sds/. Restart Codex to activate.

For terminal users who want the rai-sds binary without AI agent integration.

curl -fsSL https://raw.githubusercontent.com/renderedai/rai-synthetic-data-studio-cli/main/install.sh | bash

This downloads the pre-built binary for your platform, verifies its checksum, and installs it to ~/.local/bin/rai-sds.

To install to a custom location:

RENDEREDAI_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/renderedai/rai-synthetic-data-studio-cli/main/install.sh | bash

If the one-liner doesn't work (e.g., restricted network, unsupported platform), you can build from source.

Dependencies:

• git
• Rust/cargo — install with: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

git clone https://github.com/renderedai/synthetic-data-studio-cli.git
cd synthetic-data-studio-cli
cargo build --release
cp target/release/rai-sds ~/.local/bin/

Log in via browser (OAuth2 PKCE flow):

rai-sds auth login

Select your organization and workspace:

rai-sds orgs use
rai-sds workspaces use

# List channels and graphs
rai-sds channels get --format table
rai-sds graphs get --format table

# Create a dataset from a graph
rai-sds datasets create --graph-id <GRAPH_ID> --name "my-dataset" --runs 10

# Download a dataset
rai-sds datasets download --dataset-id <DS_ID> --extract

# Check system status
rai-sds status

rai-sds auth logout

The CLI supports multiple auth methods, resolved in this priority order:

# Via flag
rai-sds datasets get --api-key <YOUR_KEY>

# Via environment variable
export RENDEREDAI_API_KEY=<YOUR_KEY>
rai-sds datasets get

• auth — Login, logout, register, whoami
• organizations — List and manage organizations
• workspaces — Create, edit, delete, mount/unmount, set context
• members — Manage organization members
• volumes — Create, edit, delete, mount/unmount volumes
• volume-data — Upload, download, sync, search, delete volume files
• api-keys — Manage API keys
• schema — GraphQL schema introspection
• status — System health check

• channels — List channels, schemas, node docs, default graphs
• graphs — Create, edit, delete, download, stage graphs
• graph-editor — Local graph file manipulation (add/edit/remove nodes and links)
• datasets — Create, edit, delete, download, upload datasets
• preview — Create and check single-image previews
• annotations — Create, download, manage annotations
• annotation-maps — Upload, download, manage annotation maps
• analytics — Create, download analytics
• gan-models — Upload, download GAN models
• gan-datasets — Create GAN datasets
• umap — Create UMAP visualizations
• ml-models — Train and download ML models
• ml-inferences — Run ML inferences
• inpaint — Create inpaint jobs
• dataset-viewer — Control the VSCode dataset annotation viewer

Config is stored at ~/.rai-sds/config.yaml:

environment: prod
organization_id: org-123
organization_name: My Org
workspace_id: ws-456
workspace_name: My Workspace

Set via commands:

rai-sds orgs use                            # interactive picker
rai-sds orgs use --organization-id <ID>     # explicit
rai-sds workspaces use                      # interactive picker
rai-sds workspaces use --workspace-id <ID>  # explicit

MIT