Skip to main content

BEE: Build and Execution Environment

Coverage in Develop

Coverage Badge for develop

Coverage in Main

Coverage Badge for main

BEE is a workflow orchestration system designed to build containerized HPC applications and orchestrate workflows across HPC and cloud systems. BEE has adopted the Common Workflow Language (CWL) for specifying workflows. Complex scientific workflows specified by CWL are managed and visualized through a graph database, giving the user the ability to monitor the state of each task in the workflow. BEE runs jobs using the workload scheduler (i.e. Slurm or Flux) on the HPC system that tasks are specified to run on.

BEE workflows can be archived for provenance and reproducibility. BEE can orchestrate workflows with containerized applications or those built locally on a system. However, there are advantages to containerizing an application.

A container is a package of code (usually binaries) and all of that code’s dependencies (libraries, etc.). Once built, this container can be run on many different platforms.

Containers provide many benefits:

  • Users can choose their own software stack (libraries, compilers, etc.) and not be bound by the currently installed environment on any one machine.

  • Codes can be run portably across numerous platforms–all dependencies will be downloaded and installed at run time.

  • Entire workflow environments can be built into one or more containers. A user can include visualization and analysis tools along with the application. They will all work together as the application runs.

  • Provenance and history can be tracked by storing containers in a historical repository. At any time, an older container can be rerun (all of its dependencies are stored with it). Execution is repeatable and interactions between software components can be tracked.

  • Functional testing can be performed on smaller, dissimilar machines–there is no real need to test on the actual HPC platform (performance testing obviously requires target hardware).

BEE Sites

Purpose

Git Tag

Documentation

Stable release

0.1.13

https://lanl.github.io/BEE/

Pre-release

0.1.13dev1

https://lanl.github.io/BEE/0.1.13dev1/

Contact

For bugs and problems report, suggestions and other general questions regarding the BEE project, email questions to bee-dev@lanl.gov.

Contributors:

Concept and Design Contributors

  • James Ahrens

  • Curt Canada

  • Allen McPherson

  • Li-Ta Lo

  • Louis Vernon

Contributing

The BEE project adheres to style guidelines specified in setup.cfg. Before attempting to commit and push changes, please install our pre-commit githooks by running the following command in project root:

If using git –version >= 2.9:

git config core.hooksPath .githooks

Otherwise:

cp .githooks/* .git/hooks/

Using these git hooks will ensure your contributions adhere to style guidelines required for contribution. You will need to repeat these steps for every BEE repo you clone.

Release

This software has been approved for open source release and has been assigned BEE C17056.

Publications

  • An HPC-Container Based Continuous Integration Tool for Detecting Scaling and Performance Issues in HPC Applications, IEEE Transactions on Services Computing, 2024, DOI: 10.1109/TSC.2023.3337662

  • BEE Orchestrator: Running Complex Scientific Workflows on Multiple Systems, HiPC, 2021, DOI: 10.1109/HiPC53243.2021.00052

  • “BeeSwarm: Enabling Parallel Scaling Performance Measurement in Continuous Integration for HPC Applications”, ASE, 2021, DOI: 10.1109/ASE51524.2021.9678805

  • “BeeFlow: A Workflow Management System for In Situ Processing across HPC and Cloud Systems”, ICDCS, 2018, DOI: 10.1109/ICDCS.2018.00103

  • “Build and execution environment (BEE): an encapsulated environment enabling HPC applications running everywhere”, IEEE BigData, 2018, DOI: 10.1109/BigData.2018.8622572

Metadata

Release files for hpc-beeflow 0.1.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hpc-beeflow 0.1.13
File Size Uploaded
hpc_beeflow-0.1.13.tar.gz 978.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hpc-beeflow 0.1.13
File Interpreter ABI Platform
hpc_beeflow-0.1.13-py3-none-any.whl Python 3 none any Details

Total release size: 2.1 MB

Release files / hpc_beeflow-0.1.13.tar.gz

Download URL hpc_beeflow-0.1.13.tar.gz
Size 978.2 kB
Tags Source
SHA-256 checksum
How to use checksums
777df1ae2eb64876e3704fa4150e6521591b2c551243922a4f69e4bbf07fc869
BLAKE2b-256 checksum
How to use checksums
09f1dd9910f6f52ca7ac7922ad1e2dfc09ac4c7c99a7c66df2f854b66b0b4ddf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.13.0 Darwin/25.6.0

Release files / hpc_beeflow-0.1.13-py3-none-any.whl

Download URL hpc_beeflow-0.1.13-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a1a92ec4a46650bec8a884b75cb788616784c6aa76a67b9c6b8b4e6dc5a4320e
BLAKE2b-256 checksum
How to use checksums
9fd8172f53be3587dc508de394b2f5498365391384f420876b44a59ea9f1f976
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.13.0 Darwin/25.6.0
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page