checkpoint inspect

Returns detailed information about a Checkpoint: its inception time, metadata, status, file content list, and more. It outputs the information in YAML format by default.

Usage

flexai checkpoint inspect <checkpoint_name> [flags]

Arguments

checkpoint_identifier

<string>

Required

Resource Name

The name of the Checkpoint to inspect.

Flags

-h , --help

<boolean>

Optional

Flag

Displays this help page.

-j , --json

<boolean>

Optional

Flag

Displays checkpoint information in JSON format instead of the default ASCII table.

-v , --verbose

<boolean>

Optional

Flag

Provides more detailed output when inspecting a Checkpoint.

Examples

Inspecting a checkpoint

Inspect a checkpoint named my-checkpoint

flexai checkpoint inspect my-checkpoint

Which will output:

YAML

flexai checkpoint inspect response (formatted)

kind: Checkpoint
metadata:
  name: test-nanogpt-run-1
  id: 431a0ecb-cd8f-4508-8ae3-0990833a4f16
  creatorUserID: bd67af19-2599-4a57-832e-a1ac042f48be
  ownerOrgID: 270a5476-b91a-442f-8a13-852ef7bb5b94
spec:
  fromLocalFiles:
    - output/checkpoint_20250203_130043/ckpt.pt
  storageProvider: ""
  sourcePath: ""
status:
  status: available
  files:
    - path: ckpt.pt
      size: 343.79 MB
  metadata:
    name: ""
    node: ""
    step: 0
    trainLoss: 0
    evalLoss: 0
    model: ""
    version: ""
    inferenceReady: false
  storageProviderID: 00000000-0000-0000-0000-000000000000
  size: 343.79 MB
  createdAt: "2025-02-03T13:14:37.730471Z"
  updatedAt: "2025-02-03T13:14:54.591148Z"

JSON

flexai checkpoint inspect response (formatted)

{
  "kind": "Checkpoint",
  "metadata": {
    "name": "test-nanogpt-run-1",
    "id": "431a0ecb-cd8f-4508-8ae3-0990833a4f16",
    "creatorUserID": "bd67af19-2599-4a57-832e-a1ac042f48be",
    "ownerOrgID": "270a5476-b91a-442f-8a13-852ef7bb5b94"
  },
  "spec": {
    "fromLocalFiles": [
      "output/checkpoint_20250203_130043/ckpt.pt"
    ],
    "storageProvider": "",
    "sourcePath": ""
  },
  "status": {
    "status": "available",
    "files": [
      {
        "path": "ckpt.pt",
        "size": 343.79
      }
    ],
    "metadata": {
      "name": "",
      "node": "",
      "step": 0,
      "trainLoss": 0,
      "evalLoss": 0,
      "model": "",
      "version": "",
      "inferenceReady": false
    },
    "storageProviderID": "00000000-0000-0000-0000-000000000000",
    "size": 343.79,
    "createdAt": "2025-02-03T13:14:37.730471Z",
    "updatedAt": "2025-02-03T13:14:54.591148Z"
  }
}

Table

Field	Description	Data Type
kind	The type of resource	String
metadata	Metadata about the checkpoint	Object
metadata.name	The name of the checkpoint	String
metadata.id	The unique identifier of the checkpoint	String (UUID)
metadata.creatorUserID	The user ID of the checkpoint creator	String (UUID)
metadata.ownerOrgID	The organization ID that owns the checkpoint	String (UUID)
spec	Checkpoint contents details	Object
spec.fromLocalFiles	A list with the paths of the files used to create this checkpoint	String List
spec.storageProvider	The name of the Remote Storage Provider Connection, if any	String
spec.sourcePath	The path to the bucket and file or directory on the Remote Storage Provider Connection, if any	String
status	Status information of the checkpoint	Object
status.status	The current status of the checkpoint	String
status.storageProviderID	The ID of the Remote Storage Provider Connection used to upload the checkpoint, if any	String (UUID)
status.size	The total size of the checkpoint	String (File Size)
status.files	A list of files with their paths and sizes	Object List
status.files.path	The path of the file within the checkpoint	String (File Path)
status.files.size	The size of the file	String (File Size)
status.metadata.name	The human-readable name of the checkpoint	String
status.metadata.node	The Node where the checkpoint was created	String
status.metadata.step	The training step at which the checkpoint was created	Number
status.metadata.trainLoss	The training loss at the time the checkpoint was created	Number
status.metadata.evalLoss	The evaluation loss at the time the checkpoint was created	Number
status.metadata.model	The name of the base model used in the checkpoint	String
status.metadata.version	The version of the model used in the checkpoint, such as 4.53.2	String
status.metadata.inferenceReady	Indicates whether the checkpoint is ready for inference or not. Meaning it includes all necessary files and metadata required for inference to tasks	Boolean
status.createdAt	The timestamp when the checkpoint was created	String (ISO 8601)
status.updatedAt	The timestamp when the checkpoint was last updated	String (ISO 8601)