Registry /
workflow / apache-airflow-providers-singularity
Install & Compatibility
Where this runs
tested against v3.9.4 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 5.098s · 251.7MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 23.5s · import 4.764s · 249MB
251MB installed
● package 251MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
SingularityOperator
✓ from airflow.providers.singularity.operators.singularity import SingularityOperator
✗ from airflow.contrib.operators.singularity import SingularityOperator
Old contrib module was removed in Airflow 2.x
SingularityHook
✓ from airflow.providers.singularity.hooks.singularity import SingularityHook
✗ from airflow.hooks.singularity import SingularityHook
Hook moved to providers package in Airflow 2.0+
Minimal DAG using SingularityOperator to run a command in a container.
from datetime import datetime
from airflow import DAG
from airflow.providers.singularity.operators.singularity import SingularityOperator
with DAG(
dag_id='singularity_example',
start_date=datetime(2025, 1, 1),
schedule=None,
catchup=False,
) as dag:
run_singularity = SingularityOperator(
task_id='run_singularity_task',
image='docker://busybox:latest',
command='echo "Hello from Singularity"',
force_pull_image=True,
)
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'airflow.providers.singularity'
Provider not installed or Airflow version <2.0
fixInstall the provider via `pip install apache-airflow-providers-singularity`. Ensure Airflow >=2.0.
AirflowException: SingularityOperator requires singularity binary
Singularity is not installed on the worker node
fixInstall Singularity (e.g., `apt-get install singularity-container` or build from source).
AttributeError: 'SingularityOperator' object has no attribute 'image'
Using outdated provider version with different parameter name
fixUpgrade provider to latest version: `pip install -U apache-airflow-providers-singularity`.
Upgrade
Version history
3.9.4latest on PyPI · released Jun 7, 2026
Audit
Dependencies
apache-airflowrequiredCore Airflow requirement
apache-airflow-providers-cncf-kubernetesoptionalOptional dependency for Kubernetes executor compatibility