CLI overview

The Sume CLI is an agent-first wrapper over the current api.sume.com/v1 Developer API. It is intentionally separate from older consumer-product CLI surfaces.

Current status

The shipped CLI (sumelabs/cli) supports account verification, catalog discovery, jobs, input assets, Avatar 1.0, Avatar Video 1.0, bundled agent skills, schema discovery, and local diagnostics.

Generation coverage is Avatar-heavy. There are no first-class CLI subcommands today for Image 1.0, Video 1.0, or Music 1.0. For those families, call the Developer API directly (see Image, Video, Music).

Local sume mcp is not launched in current CLI releases (coming_soon). For remote MCP in Cursor/Claude, use the hosted MCP connector at https://mcp.sume.com/mcp.

Install the current native binary with the hosted installer:

For Windows PowerShell:

The installer resolves the latest sumelabs/cli GitHub Release, downloads the matching platform binary, verifies checksums.txt, and installs sume under ~/.sume-com/bin.

Then sign in with the browser flow:

API base

Common commands

Use --json for stable machine-readable output and --agent when automation is reading output that may contain sensitive URLs or account metadata. Avatar-video scripts must estimate to 4-60 seconds inclusive.

Next pages

  1. Install and update
  2. Command reference
  3. Generation workflows
  4. Hosted MCP — remote connector (preferred over local sume mcp today)