System Configuration Files

During execution, Valohai provides ten configuration files at /valohai/config/ containing execution metadata, parameters, inputs, and runtime information. These files are available in both JSON and YAML formats.

Available Files

File

Description

execution.json execution.yaml

Execution metadata (project, creator, environment)

inputs.json inputs.yaml

Downloaded input files and metadata

parameters.json parameters.yaml

Parameter values for the execution

runtime.json runtime.yaml

Runtime environment information

api.json api.yaml

Available API endpoints for the execution

execution.json / execution.yaml

Contains execution-specific metadata including project information, creator details, environment configuration, and execution status.

Basic Execution Data

JSON:

{
  "valohai.commit-identifier": "2db0b9da830749e462f0226a481559e0cf47292c",
  "valohai.creator-email": "[email protected]",
  "valohai.creator-id": 3323,
  "valohai.creator-name": "drazen",
  "valohai.environment-id": "0167d05d-a1d7-cc02-8256-6455a6ecfa56",
  "valohai.environment-name": "Microsoft Azure F2s v2 (No GPU)",
  "valohai.environment-slug": "azure-westeurope-f2sv2",
  "valohai.execution-counter": 6,
  "valohai.execution-ctime": "2025-06-07T18:49:43.984292+00:00",
  "valohai.execution-duration": null,
  "valohai.execution-id": "01974bba-352f-7c8c-d111-d8595a8649f2",
  "valohai.execution-image": "tensorflow/tensorflow:2.6.0",
  "valohai.execution-qtime": null,
  "valohai.execution-status": "created",
  "valohai.execution-step": "train-model",
  "valohai.execution-tags": [],
  "valohai.execution-title": null,
  "valohai.project-id": "0196c52a-528b-8d35-dd35-737aa5ae672b",
  "valohai.project-name": "Project/lovely-tensorflow"
}

YAML:

valohai.commit-identifier: 2db0b9da830749e462f0226a481559e0cf47292c
valohai.creator-email: [email protected]
valohai.creator-id: 3323
valohai.creator-name: drazen
valohai.environment-id: 0167d05d-a1d7-cc02-8256-6455a6ecfa56
valohai.environment-name: Microsoft Azure F2s v2 (No GPU)
valohai.environment-slug: azure-westeurope-f2sv2
valohai.execution-counter: 6
valohai.execution-ctime: '2025-06-07T18:49:43.984292+00:00'
valohai.execution-duration: null
valohai.execution-id: 01974bba-352f-7c8c-d111-d8595a8649f2
valohai.execution-image: tensorflow/tensorflow:2.6.0
valohai.execution-qtime: null
valohai.execution-status: created
valohai.execution-step: train-model
valohai.execution-tags: []
valohai.execution-title: null
valohai.project-id: 0196c52a-528b-8d35-dd35-737aa5ae672b
valohai.project-name: Project/lovely-tensorflow

Extended Execution Data

When the execution is part of a task, pipeline, or triggered workflow, additional metadata is included:

JSON:

{
  "valohai.task-id": "0192e1a3-c409-0021-c074-87370badadee",
  "valohai.task-counter": 124,
  "valohai.pipeline-id": "0192e1a4-33e3-6184-d308-0d87ab016111",
  "valohai.pipeline-counter": 1952,
  "valohai.pipeline-title": "Pathway to Production",
  "valohai.pipeline-node-id": "0192e1a7-fb19-e8c2-420c-bb53a1c0fc5d",
  "valohai.pipeline-tags": [
    "high-performance"
  ],
  "valohai.trigger-id": "0192e1a4-9332-6aaf-96ed-d78617a66ab2",
  "valohai.trigger-run-id": "0192e1a9-49a4-3efa-b8c0-a612a1e1456f",
  "valohai.trigger-title": "Webhook Automation"
}

YAML:

valohai.task-id: 0192e1a3-c409-0021-c074-87370badadee
valohai.task-counter: 124
valohai.pipeline-id: 0192e1a4-33e3-6184-d308-0d87ab016111
valohai.pipeline-counter: 1952
valohai.pipeline-title: Pathway to Production
valohai.pipeline-node-id: 0192e1a7-fb19-e8c2-420c-bb53a1c0fc5d
valohai.pipeline-tags: ["high-performance"]
valohai.trigger-id: 0192e1a4-9332-6aaf-96ed-d78617a66ab2
valohai.trigger-run-id: 0192e1a9-49a4-3efa-b8c0-a612a1e1456f
valohai.trigger-title: Webhook Automation

inputs.json / inputs.yaml

Lists all downloaded input files with their metadata, checksums, and file paths.

JSON:

{
  "dataset": {
    "files": [
      {
        "checksums": {
          "md5": "d3f9231518971c43c3e0fcf11666e88d",
          "sha1": "0d3d38ff5e5c2d0ead2486b769059b7cf895bf50",
          "sha256": "f55c2f6d1c89cdc26d5a51779deffcba8665531a0a83b557bc8fe43dae3cd118"
        },
        "download_intent": "always",
        "input_id": "01974bb9-016c-267c-61a6-8782103ecf2f",
        "name": "preprocessed_mnist.npz",
        "path": "/valohai/inputs/dataset/preprocessed_mnist.npz",
        "size": 22181444,
        "storage_uri": "azure://valohaidemo/mnist/preprocessed_mnist.npz",
        "uri": "https://valohaidemo.blob.core.windows.net/mnist/preprocessed_mnist.npz"
      }
    ],
    "input_id": "01974bb9-016c-267c-61a6-8782103ecf2f"
  }
}

YAML:

dataset:
  files:
  - checksums:
      md5: d3f9231518971c43c3e0fcf11666e88d
      sha1: 0d3d38ff5e5c2d0ead2486b769059b7cf895bf50
      sha256: f55c2f6d1c89cdc26d5a51779deffcba8665531a0a83b557bc8fe43dae3cd118
    download_intent: always
    input_id: 01974bb9-016c-267c-61a6-8782103ecf2f
    name: preprocessed_mnist.npz
    path: /valohai/inputs/dataset/preprocessed_mnist.npz
    size: 22181444
    storage_uri: azure://valohaidemo/mnist/preprocessed_mnist.npz
    uri: https://valohaidemo.blob.core.windows.net/mnist/preprocessed_mnist.npz
  input_id: 01974bb9-016c-267c-61a6-8782103ecf2f

parameters.json / parameters.yaml

Contains parameter values defined for the execution.

JSON:

{
  "epochs": 5,
  "learning_rate": 0.001,
  "batch_size": 32,
  "model_architecture": "resnet50"
}

YAML:

epochs: 5
learning_rate: 0.001
batch_size: 32
model_architecture: resnet50

runtime.json / runtime.yaml

Provides runtime environment information including runner identity and node details.

JSON:

{
  "runner.identity": "azwesteuropef2sv2-hsygefxy",
  "runner.nodename": "azwesteuropef2sv2-hsygefxy"
}

YAML:

runner.identity: azwesteuropef2sv2-hsygefxy
runner.nodename: azwesteuropef2sv2-hsygefxy

api.json / api.yaml

Contains available API endpoints for the execution with authentication headers.

JSON:

{
  "set_status_detail": {
    "method": "POST",
    "url": "https://app.valohai.com/api/v0/executions/018aa9d9-f899-8e4b-80f9-464ea1c855eb/set_status_detail/",
    "headers": {
      "Authorization": "Execution-Token {...}"
    }
  },
  "trigger_catalog": {
    "method": "POST",
    "url": "https://app.valohai.com/api/v0/worker-trigger-catalog/018aa9d9-f899-8e4b-80f9-464ea1c855eb/",
    "headers": {
      "Authorization": "Execution-Token {...}"
    }
  }
}

YAML:

set_status_detail:
  method: POST
  url: https://app.valohai.com/api/v0/executions/018aa9d9-f899-8e4b-80f9-464ea1c855eb/set_status_detail/
  headers:
    Authorization: Execution-Token {...}
trigger_catalog:
  method: POST
  url: https://app.valohai.com/api/v0/worker-trigger-catalog/018aa9d9-f899-8e4b-80f9-464ea1c855eb/
  headers:
    Authorization: Execution-Token {...}

File Access Examples

Python (JSON):

import json

# Read parameters
with open("/valohai/config/parameters.json") as f:
    params = json.load(f)

# Read execution metadata
with open("/valohai/config/execution.json") as f:
    execution = json.load(f)

# Read input file information
with open("/valohai/config/inputs.json") as f:
    inputs = json.load(f)

Python (YAML):

import yaml

# Read parameters
with open("/valohai/config/parameters.yaml") as f:
    params = yaml.safe_load(f)

# Read execution metadata
with open("/valohai/config/execution.yaml") as f:
    execution = yaml.safe_load(f)

PreviousEnvironment Variables NextAdvanced Features

Last updated 1 month ago

Was this helpful?

hashtagAvailable Files

hashtagexecution.json / execution.yaml

hashtagBasic Execution Data

hashtagExtended Execution Data

hashtaginputs.json / inputs.yaml

hashtagparameters.json / parameters.yaml

hashtagruntime.json / runtime.yaml

hashtagapi.json / api.yaml

hashtagFile Access Examples

Available Files

execution.json / execution.yaml

Basic Execution Data

Extended Execution Data

inputs.json / inputs.yaml

parameters.json / parameters.yaml

runtime.json / runtime.yaml

api.json / api.yaml

File Access Examples