StackMoreLayersДокументация
CLI

Справочник команд sml

Все команды, флаги и примеры вызова, доступные в sml.

Справочник собран из тех же команд, что и бинарник sml. Практические сценарии находятся в руководстве CLI, а точные поля JSON-запросов — в справочнике API.

Общие флаги

  • --allow-custom-api-origin — allow authentication against a non-production, non-loopback API host
  • --api-url — public API base URL По умолчанию: https://stackmorelayers.ai/api/v1.
  • --no-color — disable color output
  • -o, --output — output mode: auto, table, or json По умолчанию: auto.

sml auth

Manage public API authentication

sml auth

sml auth login

Sign in through a browser or save a personal API token

sml auth login [flags]

Флаги:

  • --no-browser — print the verification URL and code without opening a browser
  • --token — prompt for a personal API token without exposing it in argv
  • --token-stdin — read a personal API token from standard input (never from argv)

sml auth logout

Close this CLI login and remove its local credential

sml auth logout

sml auth status

Validate the current token and show its safe identity

sml auth status

sml competitions

Inspect competitions through the public API

sml competitions

sml competitions assets

Manage competition-level files

sml competitions assets

sml competitions assets delete

Remove a competition-level asset

sml competitions assets delete COMPETITION_ID KIND [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm asset deletion

sml competitions assets upload

Upload a competition image or starter asset

sml competitions assets upload COMPETITION_ID KIND FILE [flags]

Флаги:

  • --alt — accessible image alternative text
  • --idempotency-key — stable retry key (generated when omitted)
  • --title — baseline notebook title

sml competitions create

Create a draft competition from a JSON contract

sml competitions create [flags]

Флаги:

  • --from — JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions delete

Delete a draft competition

sml competitions delete COMPETITION_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm destructive deletion

sml competitions get

Get one competition

sml competitions get COMPETITION_ID

sml competitions invites

Issue and manage invite links

sml competitions invites

sml competitions invites create

Issue an invite link from a JSON request

sml competitions invites create COMPETITION_ID [flags]

Флаги:

  • --from — JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions invites delete

Delete an invite link

sml competitions invites delete COMPETITION_ID PUBLIC_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm destructive deletion

sml competitions invites list

List invite links

sml competitions invites list COMPETITION_ID

sml competitions invites update

Update or revoke an invite link from a JSON request

sml competitions invites update COMPETITION_ID PUBLIC_ID [flags]

Флаги:

  • --from — JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions leaderboard

Get a competition leaderboard

sml competitions leaderboard COMPETITION_ID [flags]

Флаги:

  • --phase — only show standings for this phase По умолчанию: 0.

sml competitions list

List competitions the current identity can administer

sml competitions list [flags]

Флаги:

  • --page — 1-based page number По умолчанию: 1.
  • --page-size — items per page (1-200) По умолчанию: 50.
  • -q, --query — title, slug, and short-description search
  • --visibility — private, organization, unlisted, host_only, or public

sml competitions organizers

Manage co-organizers

sml competitions organizers

sml competitions organizers add

Add one platform-linked co-organizer

sml competitions organizers add COMPETITION_ID [flags]

Флаги:

  • --email — exact email address
  • --idempotency-key — stable retry key (generated when omitted)
  • --user-id — exact numeric user id По умолчанию: 0.
  • --username — exact username

sml competitions organizers list

List co-organizers

sml competitions organizers list COMPETITION_ID

sml competitions organizers remove

Remove a co-organizer and their host tuple

sml competitions organizers remove COMPETITION_ID USER_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm organizer removal

sml competitions participants

Review and decide competition access

sml competitions participants

sml competitions participants approve

Approve a participant

sml competitions participants approve COMPETITION_ID PARTICIPANT_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)

sml competitions participants deny

Deny a participant

sml competitions participants deny COMPETITION_ID PARTICIPANT_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --reason — participant-visible denial reason

sml competitions participants list

List and filter the participant roster

sml competitions participants list COMPETITION_ID [flags]

Флаги:

  • --page — 1-based page number По умолчанию: 1.
  • --page-size — items per page (1-200) По умолчанию: 50.
  • --search — username or email search
  • --status — approved, pending, or denied

sml competitions participation

Join competitions and inspect your participant state

sml competitions participation

sml competitions participation join

Join or request access to a competition

sml competitions participation join COMPETITION_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --secret — private competition invite secret

sml competitions participation status

Show your registration and submit capability

sml competitions participation status COMPETITION_ID

sml competitions phases

Manage competition phases

sml competitions phases

sml competitions phases assets

Manage phase evaluation files

sml competitions phases assets

sml competitions phases assets delete

Remove a phase asset

sml competitions phases assets delete COMPETITION_ID PHASE_ID KIND [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm phase asset deletion

sml competitions phases assets preflight

Verify a notebook phase against the sealed evaluation contract

sml competitions phases assets preflight COMPETITION_ID PHASE_ID

sml competitions phases assets upload

Upload phase data, evaluator, sample, or baseline

sml competitions phases assets upload COMPETITION_ID PHASE_ID KIND FILE [flags]

Флаги:

  • --display-name — sample or baseline label
  • --id-column — ground-truth id column
  • --idempotency-key — stable retry key (generated when omitted)
  • --public-percent — public ground-truth split percentage По умолчанию: 30.
  • --split-strategy — column or public_percent

sml competitions phases bind-answers

Bind an existing dataset version as the phase answers

sml competitions phases bind-answers COMPETITION_ID PHASE_ID [flags]

Флаги:

  • --from — JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)
  • --source — dataset or binding По умолчанию: dataset.

sml competitions phases create

Create a phase from JSON

sml competitions phases create COMPETITION_ID [flags]

Флаги:

  • --from — JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions phases delete

Delete an empty phase

sml competitions phases delete COMPETITION_ID PHASE_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm destructive deletion

sml competitions phases get

Get one phase

sml competitions phases get COMPETITION_ID PHASE_ID

sml competitions phases list

List phases

sml competitions phases list COMPETITION_ID

sml competitions phases update

Update a phase from JSON

sml competitions phases update COMPETITION_ID PHASE_ID [flags]

Флаги:

  • --from — JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions policies

Manage notebook and compute policies

sml competitions policies

sml competitions policies get

Get competition and phase policies

sml competitions policies get COMPETITION_ID

sml competitions policies update

Update notebook and compute policies from JSON

sml competitions policies update COMPETITION_ID [flags]

Флаги:

  • --from — JSON policy patch, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions publish

Publish a readiness-approved competition

sml competitions publish COMPETITION_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)

sml competitions readiness

Show publish blockers and warnings

sml competitions readiness COMPETITION_ID

sml competitions resources

Bind versioned datasets and models to a competition

sml competitions resources

sml competitions resources datasets

Manage competition datasets

sml competitions resources datasets

sml competitions resources datasets bind

Bind an approved version from a JSON request

sml competitions resources datasets bind COMPETITION_ID [flags]

Флаги:

  • --from — JSON binding request, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions resources datasets list

List datasets bound to a competition

sml competitions resources datasets list COMPETITION_ID

sml competitions resources datasets unbind

Detach a versioned dataset

sml competitions resources datasets unbind COMPETITION_ID BINDING_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm resource detachment

sml competitions resources datasets update

Update dataset presentation or access settings

sml competitions resources datasets update COMPETITION_ID BINDING_ID [flags]

Флаги:

  • --from — JSON binding patch, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions resources models

Manage competition models

sml competitions resources models

sml competitions resources models bind

Bind an approved version from a JSON request

sml competitions resources models bind COMPETITION_ID [flags]

Флаги:

  • --from — JSON binding request, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml competitions resources models list

List models bound to a competition

sml competitions resources models list COMPETITION_ID

sml competitions resources models unbind

Detach a versioned model

sml competitions resources models unbind COMPETITION_ID BINDING_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm resource detachment

sml competitions submissions

List competition submissions

sml competitions submissions COMPETITION_ID [flags]

Флаги:

  • --page — 1-based page number По умолчанию: 1.
  • --page-size — items per page (1-200) По умолчанию: 50.
  • --phase — only list submissions from this phase По умолчанию: 0.

sml competitions update

Update competition settings or deadlines from JSON

sml competitions update COMPETITION_ID [flags]

Флаги:

  • --from — JSON patch file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml completion

Generate a shell completion script

sml completion [bash|zsh|fish|powershell]

sml datasets

Inspect datasets through the public API

sml datasets

sml datasets delete

Delete an owned dataset

sml datasets delete DATASET_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm destructive deletion

sml datasets files

List safe file metadata for one version

sml datasets files DATASET_ID VERSION_ID

sml datasets get

Get one dataset

sml datasets get DATASET_ID

sml datasets import

Import a dataset from an external source

sml datasets import [SOURCE_URI] [flags]

Флаги:

  • --from — full JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)
  • --mode — model import mode: persist or reference По умолчанию: persist.
  • --source-type — source adapter such as url, github, huggingface, or auto По умолчанию: url.
  • --title — catalog title
  • --visibility — private, shared, or public

sml datasets job

Inspect or wait for a dataset import job

sml datasets job JOB_ID [flags]

Флаги:

  • --interval — poll interval with --watch По умолчанию: 2s.
  • --timeout — maximum watch duration По умолчанию: 30m0s.
  • --watch — poll until success or failure

sml datasets list

List visible datasets

sml datasets list [flags]

Флаги:

  • --page — 1-based page number По умолчанию: 1.
  • --page-size — items per page (1-200) По умолчанию: 50.
  • -q, --query — title and metadata search
  • --visibility — private, shared, or public

sml datasets publish

Publish one immutable dataset version

sml datasets publish DATASET_ID VERSION_ID [flags]

Флаги:

  • --from — optional JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)
  • --visibility — resulting visibility

sml datasets update

Update mutable dataset metadata from JSON

sml datasets update DATASET_ID [flags]

Флаги:

  • --from — JSON patch file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml datasets upload

Upload a local dataset with automatic resume

sml datasets upload FILE [flags]

Флаги:

  • --concurrency — parallel part uploads (1-16) По умолчанию: 4.
  • --dataset-id — existing dataset for a new version
  • --description — dataset description
  • --license — dataset license identifier
  • --no-resume — start a new upload session
  • --title — catalog title
  • --visibility — private, shared, or public

sml datasets validate

Validate one immutable dataset version

sml datasets validate DATASET_ID VERSION_ID [flags]

Флаги:

  • --from — optional JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml datasets versions

List immutable dataset versions

sml datasets versions DATASET_ID

sml doctor

Check CLI configuration, credentials, and public API compatibility

sml doctor

sml models

Inspect models through the public API

sml models

sml models delete

Delete an owned model

sml models delete MODEL_ID [flags]

Флаги:

  • --idempotency-key — stable retry key (generated when omitted)
  • --yes — confirm destructive deletion

sml models files

List safe file metadata for one version

sml models files MODEL_ID VERSION_ID

sml models get

Get one model

sml models get MODEL_ID

sml models import

Import a model from an external source

sml models import [SOURCE_URI] [flags]

Флаги:

  • --from — full JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)
  • --mode — model import mode: persist or reference По умолчанию: persist.
  • --source-type — source adapter such as url, github, huggingface, or auto По умолчанию: auto.
  • --title — catalog title
  • --visibility — private, shared, or public

sml models job

Inspect or wait for a model import job

sml models job JOB_ID [flags]

Флаги:

  • --interval — poll interval with --watch По умолчанию: 2s.
  • --timeout — maximum watch duration По умолчанию: 30m0s.
  • --watch — poll until success or failure

sml models list

List visible models

sml models list [flags]

Флаги:

  • --page — 1-based page number По умолчанию: 1.
  • --page-size — items per page (1-200) По умолчанию: 50.
  • -q, --query — title and metadata search
  • --visibility — private, shared, or public

sml models publish

Publish one immutable model version

sml models publish MODEL_ID VERSION_ID [flags]

Флаги:

  • --from — optional JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)
  • --visibility — resulting visibility

sml models update

Update mutable model metadata from JSON

sml models update MODEL_ID [flags]

Флаги:

  • --from — JSON patch file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml models upload

Upload a local model with automatic resume

sml models upload FILE [flags]

Флаги:

  • --concurrency — parallel part uploads (1-16) По умолчанию: 4.
  • --model-alias — model alias
  • --no-resume — start a new upload session
  • --target-name — model target name
  • --target-namespace — model target namespace
  • --title — catalog title
  • --visibility — private, shared, or public

sml models validate

Validate one immutable model version

sml models validate MODEL_ID VERSION_ID [flags]

Флаги:

  • --from — optional JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml models versions

List immutable model versions

sml models versions MODEL_ID

sml self

Manage the sml executable

sml self

sml self update

Install the latest verified sml release

sml self update [flags]

Флаги:

  • --check — check for an update without installing it
  • --install-dir — install into this directory instead of replacing the current executable
  • --version — install an exact published semantic version

sml submissions

Submit work and inspect your execution state

sml submissions

sml submissions create

Submit an already registered server-side source

sml submissions create COMPETITION_ID [flags]

Флаги:

  • --from — JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)

sml submissions download

Download the file a submission was created from

sml submissions download SUBMISSION_ID [flags]

Флаги:

  • --to — local path to write the file to

sml submissions get

Get safe status, diagnostics, and provenance

sml submissions get SUBMISSION_ID [flags]

Флаги:

  • --interval — poll interval with --watch По умолчанию: 2s.
  • --timeout — maximum watch duration По умолчанию: 30m0s.
  • --watch — poll until the submission is scored, failed, rejected, or cancelled

sml submissions list

List your submissions across competitions

sml submissions list [flags]

Флаги:

  • --page — 1-based page number По умолчанию: 1.
  • --page-size — items per page (1-200) По умолчанию: 50.

sml submissions submit-file

Upload and submit a local prediction or code bundle

sml submissions submit-file COMPETITION_ID FILE [flags]

Флаги:

  • --content-type — override detected media type
  • --description — submission description
  • --idempotency-key — stable retry key (generated when omitted)
  • --kind — prediction_file or code_bundle По умолчанию: prediction_file.
  • --name — submission display name
  • --phase — target phase id (required) По умолчанию: 0.

sml submissions submit-notebook

Snapshot and submit an owned notebook workspace

sml submissions submit-notebook WORKSPACE_ID [flags]

Флаги:

  • --description — submission description
  • --from — optional JSON request file, or - for standard input
  • --idempotency-key — stable retry key (generated when omitted)
  • --name — submission display name
  • --notebook-path — workspace-relative notebook path

sml version

Print sml build information

sml version [flags]

Флаги:

  • --short — print only the semantic version

sml workspaces

Inspect notebook workspaces owned by the current user

sml workspaces

sml workspaces get

Get one owned workspace

sml workspaces get WORKSPACE_ID

sml workspaces list

List owned notebook workspaces

sml workspaces list [flags]

Флаги:

  • --page — 1-based page number По умолчанию: 1.
  • --page-size — items per page (1-200) По умолчанию: 50.

На этой странице

Общие флагиsml authsml auth loginsml auth logoutsml auth statussml competitionssml competitions assetssml competitions assets deletesml competitions assets uploadsml competitions createsml competitions deletesml competitions getsml competitions invitessml competitions invites createsml competitions invites deletesml competitions invites listsml competitions invites updatesml competitions leaderboardsml competitions listsml competitions organizerssml competitions organizers addsml competitions organizers listsml competitions organizers removesml competitions participantssml competitions participants approvesml competitions participants denysml competitions participants listsml competitions participationsml competitions participation joinsml competitions participation statussml competitions phasessml competitions phases assetssml competitions phases assets deletesml competitions phases assets preflightsml competitions phases assets uploadsml competitions phases bind-answerssml competitions phases createsml competitions phases deletesml competitions phases getsml competitions phases listsml competitions phases updatesml competitions policiessml competitions policies getsml competitions policies updatesml competitions publishsml competitions readinesssml competitions resourcessml competitions resources datasetssml competitions resources datasets bindsml competitions resources datasets listsml competitions resources datasets unbindsml competitions resources datasets updatesml competitions resources modelssml competitions resources models bindsml competitions resources models listsml competitions resources models unbindsml competitions submissionssml competitions updatesml completionsml datasetssml datasets deletesml datasets filessml datasets getsml datasets importsml datasets jobsml datasets listsml datasets publishsml datasets updatesml datasets uploadsml datasets validatesml datasets versionssml doctorsml modelssml models deletesml models filessml models getsml models importsml models jobsml models listsml models publishsml models updatesml models uploadsml models validatesml models versionssml selfsml self updatesml submissionssml submissions createsml submissions downloadsml submissions getsml submissions listsml submissions submit-filesml submissions submit-notebooksml versionsml workspacessml workspaces getsml workspaces list