# astronomer/dag-factory

Construct Apache Airflow DAGs Declaratively via YAML configuration files

Repository: https://github.com/astronomer/dag-factory
Canonical: https://ross.abutalabs.com/products/dag-factory
Homepage: https://astronomer.github.io/dag-factory/latest/
Language: Python
License: Apache-2.0
License Family: permissive
Topics: airflow, apache-airflow, python, dags
Last push: 2026-08-21T16:28:07+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 71, longevity 100
- inputs: {"age_days": 2843, "days_push": 12, "days_rel": 118, "gap_med": 47.5, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1453, forks 238 (observed 2026-08-28T04:04:46.582327+00:00)

## What it is
dag-factory is a Python library for Apache Airflow that lets users define DAGs declaratively via YAML configuration files instead of writing Python code. It supports custom operators, dynamic task mapping, TaskFlow pipelines, callbacks, and is compatible with Airflow 2.9+ and Airflow 3.

## Use cases
- define airflow dags in yaml instead of python
- generate airflow workflows from configuration files
- let non-python users author data pipelines
- reduce duplicated boilerplate across airflow dags
- manage many similar dags from one config
- configure kubernetes pod operator tasks via yaml

## When to choose
- your team maintains many similar Airflow DAGs with repetitive boilerplate
- pipeline authors know YAML but not Python or Airflow internals
- you want DAG definitions separated from code for review or governance
- you need Airflow 3 compatibility with declarative DAG generation

## When to avoid
- your DAGs require complex dynamic logic that YAML cannot express
- you have only a handful of simple DAGs already written in Python
- you use an Airflow version older than 2.9

## Facets
- artifact type: library
- maturity: stable
- function: workflow-automation, configuration-management, developer-tools
- domain: developer-tools
- platform: python, windows, self-hosted
- tags: apache-airflow, yaml, dags, orchestration, declarative-configuration, data-pipelines, data-engineering, automation, linux, macos, docker

## Member repositories
- astronomer/dag-factory (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:46.582327+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:35:44.602051+00:00, confidence not recorded.
  - readme: https://github.com/astronomer/dag-factory (fetched 2026-08-28T04:04:46.582327+00:00, sha e27bbbcade48)
  - homepage: https://astronomer.github.io/dag-factory/latest/ (fetched 2026-08-29T11:45:02.252693+00:00, sha 9a64bfc533e7)
  - registry_pypi: https://pypi.org/pypi/dag-factory/json (fetched 2026-08-29T11:45:02.255349+00:00, sha df3514ef0c78)
- Data as of 2026-08-30T08:39:29.467469+00:00.