---
id: valohai-yaml
version: "0.58.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# valohai-yaml — Valohai.yaml validation and parsing

License: permissive · Maintenance: active · Downloads: 137.2K/mo

## What it is and what it does

valohai-yaml is a parser and validator for valohai.yaml files, the configuration format used to define machine learning workloads and pipelines in the Valohai ecosystem. It provides both programmatic and command-line interfaces to validate YAML structure and parse it into Python objects that expose pipeline steps, parameters, and other configuration details.

The package depends on jsonschema, leval, and pyyaml to perform schema validation and YAML parsing. It is actively maintained, supports Python 3.9 through 3.13, and carries no known security vulnerabilities. Use it when you need to validate or programmatically inspect valohai.yaml files as part of a Valohai-integrated ML workflow.

Use it for:

- Validate valohai.yaml files in CI/CD pipelines before submitting workloads to Valohai
- Programmatically inspect pipeline steps and commands from valohai.yaml in custom tooling
- Parse and extract configuration metadata from ML project definitions for automation or reporting
- Integrate valohai.yaml validation into local development workflows via the command-line tool

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses and validates valohai.yaml configuration files used to define machine learning workloads and pipelines on the Valohai platform.

Yes. If you use Valohai for ML workload orchestration, this package is essential for validating and parsing your configuration files. Low install friction, active maintenance, MIT license, no known vulnerabilities, and a straightforward API make it a reliable choice for both CI/CD integration and programmatic configuration inspection.

## Install

pip install valohai-yaml
uv add valohai-yaml
poetry add valohai-yaml

## Installing valohai-yaml

Before you install: Low install friction with three lightweight runtime dependencies (jsonschema, leval, pyyaml). Active maintenance with a release 1 day old and commits current as of 2026-08-13.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both commercial and open-source projects.

Quickstart:

pip install valohai-yaml

from valohai_yaml import validate, parse

with open('valohai.yaml') as f:
    validate(f)

with open('valohai.yaml') as f:
    config = parse(f)
    print(config.steps['step_name'].command)

Verify before relying:

- Whether the package handles all Valohai YAML schema versions or only current versions
- Performance characteristics when parsing large or complex pipeline definitions

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 137.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

valohai yaml validation, ml pipeline configuration parser, valohai config parsing, yaml validation for ml workflows, valohai workload definition, ml-workflow, yaml-validation, valohai-ecosystem

[View on SkillFed](https://skillfed.io/packages/valohai-yaml) · [View on PyPI](https://pypi.org/project/valohai-yaml/)