What problem does it solve?
It prevents misconfigured dbt Fusion runs in Astronomer Cosmos by guiding you through Fusion-specific setup constraints and validations, so your Airflow DAGs parse and execute correctly on supported warehouses.
Core Features & Use Cases
- Cosmos 1.11+ Fusion compatibility guardrails: Ensures you’re using the dbt engine correctly (Fusion vs Core) and Cosmos versions that support Fusion.
- Local-only ExecutionMode configuration: Sets up Cosmos to invoke the Fusion binary using
ExecutionMode.LOCAL and the correct dbt_executable_path.
- Warehouse support verification: Covers supported targets (Snowflake, Databricks, Bigquery, Redshift in preview) and explicitly avoids unsupported cases.
- Operational setup for Airflow: Covers how to install the dbt Fusion binary into the Airflow runtime image and how to choose a parsing strategy (automatic, manifest, or dbt_ls).
Quick Start
Use cosmos-dbt-fusion to configure your Airflow DAG with Cosmos 1.11+, install the dbt Fusion binary in the runtime image, and set ExecutionConfig to use InvocationMode.SUBPROCESS with the Fusion binary path while keeping execution local.