OpenSet

An open, sport-agnostic standard for representing structured training workouts and programs as machine-readable data.

What is OpenSet?

OpenSet is a JSON-based data standard for describing training workouts across any sport or physical activity. It defines a strict vocabulary for how workouts are structured — from high-level programs down to individual sets and their prescribed dimensions — so that coaches, athletes, and software tools can exchange training data without ambiguity.

Quick Start

Validate a document

npx @diby/openset-validator validate ./my-workout.json --summary

Use TypeScript types

npm install @diby/openset-types

import type { Workout, Set, Exercise } from '@diby/openset-types';

Validate programmatically

npm install @diby/openset-validator

import { validate } from '@diby/openset-validator';

const result = validate(myDocument);
// { valid: true, errors: [], warnings: [] }

Minimal Example

{
  "openset_version": "1.0",
  "type": "workout",
  "name": "Upper Body",
  "date": "2026-02-19",
  "blocks": [
    {
      "name": "Main Work",
      "series": [
        {
          "execution_mode": "SUPERSET",
          "rounds": { "type": "fixed", "value": 3 },
          "rest_after": { "type": "fixed", "value": 90, "unit": "s" },
          "exercises": [
            {
              "exercise_id": "bench_press",
              "sets": [
                { "dimensions": ["reps", "load"], "reps": { "type": "fixed", "value": 8 }, "load": { "type": "fixed", "value": 80, "unit": "kg" } },
                { "dimensions": ["reps", "load"], "reps": { "type": "fixed", "value": 8 }, "load": { "type": "fixed", "value": 80, "unit": "kg" } },
                { "dimensions": ["reps", "load"], "reps": { "type": "fixed", "value": 8 }, "load": { "type": "fixed", "value": 80, "unit": "kg" } }
              ]
            },
            {
              "exercise_id": "pull_up",
              "sets": [
                { "dimensions": ["reps"], "reps": { "type": "fixed", "value": 10 } },
                { "dimensions": ["reps"], "reps": { "type": "fixed", "value": 10 } },
                { "dimensions": ["reps"], "reps": { "type": "fixed", "value": 10 } }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Project Structure

openset/
├── spec/v1/                    # Specification files
│   ├── schema/                 # JSON Schemas and vocabulary
│   ├── libraries/              # Canonical exercise library
│   └── types/                  # TypeScript type definitions
├── packages/
│   ├── typescript-types/       # @diby/openset-types npm package
│   └── validator/              # @diby/openset-validator npm package
├── examples/                   # Example OpenSet documents
├── tools/convert/              # LLM conversion prompt
└── website/                    # Documentation website

Core Concepts

Data Hierarchy: Program > Phase > Workout > Block > Series > Exercise > Set

Document types: workout, program, workout_library

Workout is the minimum valid standalone document.

Execution Modes define how exercises in a series flow: SEQUENTIAL, CIRCUIT, SUPERSET, AMRAP, FOR_TIME, INTERVAL, TABATA, EMOM, LADDER, CLUSTER.

Set Dimensions define the measurable axes of each set. The dimensions array declares which dimensions are required (e.g., ["reps", "load"]), and any other known dimension can be added freely.

Value Types describe how targets are prescribed: fixed (exact), range (min/max), min (at least), amrap (as many as possible), max (maximum effort), any (no target).

Packages

Package	Description
@diby/openset-types	TypeScript type definitions
@diby/openset-validator	CLI and programmatic validator
@openset/codegen	Fluent TypeScript builder for documents

Publishing packages

These packages are published to npm under the @diby scope. You need npm publish access.

@diby/openset-types

# from repo root
npm run test -w @diby/openset-types
npm run build -w @diby/openset-types

# bump version (choose patch/minor/major)
npm version patch -w @diby/openset-types

# publish
npm publish -w @diby/openset-types --access public

If you are publishing a prerelease, use npm version prerelease -w <package> and add --tag next to npm publish.

Contributing

See CONTRIBUTING.md for guidelines on adding exercises, proposing new dimensions, and contributing to the spec. A list of contributors is in CONTRIBUTORS.md.

Contact

For general questions, partnerships, or community inquiries, email hello@openset.dev.

For security vulnerabilities, see SECURITY.md and use security@openset.dev.

License

MIT