CLI overview

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

Current status

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

Most of the generation coverage is for Avatar. At this time, the CLI has no first-class subcommands for Image 1.0, Video 1.0, or Music 1.0. For those families, call the Developer API directly (refer to Image, Video, Music).

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

Use the hosted installer to install the current native binary:

For Windows PowerShell:

The installer finds the latest sumelabs/cli GitHub Release. Then it downloads the binary for your platform and compares the binary with checksums.txt. Last, it installs sume in ~/.sume-com/bin.

Then use the browser flow to sign in:

API base

Common commands

For stable machine-readable output, use --json. When automation reads output that can contain sensitive URLs or account metadata, use --agent. The estimated length of an avatar-video script must be 4-60 seconds inclusive.

Next pages

  1. Install and update
  2. Command reference
  3. Generation workflows
  4. Hosted MCP — remote connector (at this time, we recommend it over local sume mcp)