fasthep-flow

fasthep-flow provides the core FAST-HEP workflow language and execution engine.

It is responsible for:

workflow compilation
execution planning
runtime orchestration
registry/profile loading
backend interfaces
artifact lifecycle management

The Python import namespace is:

import hepflow

Scope

fasthep-flow is intentionally lightweight and domain-agnostic.

It does not implement:

ROOT IO
histogram filling
HEP-specific transforms
plotting/rendering
experiment-specific analysis logic

Those capabilities are provided by companion FAST-HEP packages.

Recommended companion packages

For High Energy Physics (HEP) workflows, most users will also want:

fasthep-carpenter
- HEP analysis transforms
- ROOT/awkward sources and writers
- histogramming
- cutflows
- object reconstruction helpers
fasthep-curator
- dataset inspection
- schema snapshots
- diagnostics
- runtime hooks
fasthep-render
- plotting
- tables
- reports
- render styles
fasthep-cli
- the fasthep command-line interface

Alternatively, install the meta package:

pip install fasthep

Installation

Core workflow package only:

pip install fasthep-flow

Development environment:

pixi install
pixi run ci

Minimal example

from hepflow.api import compile_workflow_file, run_workflow_file

compile_workflow_file(
    "analysis/workflow.yaml",
    work_dir="build/example",
)

run_workflow_file(
    "analysis/workflow.yaml",
    outdir="build/example",
)

Design principles

fasthep-flow focuses on:

small and composable interfaces
explicit workflow compilation stages
registry-driven extensibility
backend-independent execution planning
reproducible workflow artifacts
minimal domain assumptions

The long-term goal is to make the workflow layer reusable beyond High Energy Physics.

Documentation

Main FAST-HEP documentation:

https://fast-hep.github.io

API documentation for this package:

https://fasthep-flow.readthedocs.io/en/latest/

Repository

Main FAST-HEP repository and project links:

https://github.com/FAST-HEP/fasthep

Contributing

Contribution guidelines, development setup, and project-wide documentation are maintained centrally in the main FAST-HEP repository.

Legacy branch

The pre-split prototype implementation is preserved in the legacy branch.

The new main branch contains the split-package architecture.

Status

FAST-HEP is currently in active pre-alpha development.

Interfaces may still evolve rapidly while the package split and stabilization work continues.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fasthep_flow-2026.8.4.tar.gz (123.1 kB view details)

Uploaded Aug 28, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fasthep_flow-2026.8.4-py3-none-any.whl (159.9 kB view details)

Uploaded Aug 28, 2026 Python 3

File details

Details for the file fasthep_flow-2026.8.4.tar.gz.

File metadata

Download URL: fasthep_flow-2026.8.4.tar.gz
Upload date: Aug 28, 2026
Size: 123.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fasthep_flow-2026.8.4.tar.gz
Algorithm	Hash digest
SHA256	`4b73c16aedce8863b6535d44ad12c03ec355130ee644eecbe61571c852dc3b3b`
MD5	`e36946821ea9b97899b4bd364f1ccd6c`
BLAKE2b-256	`eaed26fb5c36da5091da5c313710ba6170c514001c2c543f07bea71608fac5a7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fasthep_flow-2026.8.4.tar.gz:

Publisher: cd.yml on FAST-HEP/fasthep-flow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fasthep_flow-2026.8.4.tar.gz
- Subject digest: 4b73c16aedce8863b6535d44ad12c03ec355130ee644eecbe61571c852dc3b3b
- Sigstore transparency entry: 2626062671
- Sigstore integration time: Aug 28, 2026
Source repository:
- Permalink: FAST-HEP/fasthep-flow@2322e3514ac858d89cbf3717199c2ccaaf4f4032
- Branch / Tag: refs/tags/2026.08.4
- Owner: https://github.com/FAST-HEP
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: cd.yml@2322e3514ac858d89cbf3717199c2ccaaf4f4032
- Trigger Event: push