Skip to content

Cosmos Documentation

Cosmos is a provenance-first video normalization toolkit.

It is designed to be safe for both humans and automation:

  • one CLI (cosmos)
  • one SDK (cosmos.sdk.*)
  • deterministic provenance artifacts for every real output

What Cosmos is (and is not)

Cosmos is currently strongest in two areas:

  • COSM-native ingest: manifest-aware conversion from camera export layouts to normalized MP4 clips.
  • General MP4 post-processing: crop, preview, optimize, and provenance operations that work on standard MP4 inputs.

Cosmos is not limited to a single camera vendor at the architecture level. The long-term model is:

  • many ingest adapters
  • one normalized runtime contract
  • one provenance model

Start with the workflow you need

Ingest raw camera output into MP4 clips

Create square/rect views and visual QA previews

Optimize existing MP4s for web delivery

Use cosmos optimize run when you need faststart relocation, optional transcode transforms, and reproducible optimize provenance.

Command quickstart

cosmos --help
cosmos ingest run --help
cosmos crop run --help
cosmos optimize run --help
cosmos crop preview --help
cosmos provenance --help

Provenance is a first-class contract

Cosmos writes run-level and artifact-level JSON sidecars so downstream systems can audit exactly how each file was produced.

Agent-friendly usage (Cosmos skill)

The canonical Cosmos skill package is versioned in-repo and should be used when planning or shipping CLI/SDK/provenance changes.

For a docs-local summary, see Cosmos Skill.

Reference map