
Cosmos Dbt Fusion
If you're running dbt Fusion (not Core) with Astronomer Cosmos on Airflow, this walks you through the Fusion-specific setup that trips people up. It requires Cosmos 1.11 or later and only works with LOCAL execution mode pointing to the Fusion binary. The skill covers binary installation via Dockerfile, ExecutionConfig constraints, and warehouse compatibility (Snowflake, Databricks, BigQuery, Redshift only during preview). Notably clear about what won't work: no async mode, no virtualenv since Fusion is a binary. Includes both DbtDag and DbtTaskGroup patterns with actual code. The validation checklist at the end is practical, especially the note about testing a manual run before declaring victory.
- skills.sh installs
- 925
- GitHub stars
- 459
- last updated
- Aug 21, 2026
Install
$ npx -y skills add astronomer/agents --skill cosmos-dbt-fusion --agent claude-codeInstalls into .claude/skills of the current project.
Files
Cosmos + dbt Fusion: Implementation Checklist
Execute steps in order. This skill covers Fusion-specific constraints only.
Version note: dbt Fusion support was introduced in Cosmos 1.11.0. Requires Cosmos ≥1.11.
Reference: See reference/cosmos-config.md for ProfileConfig, operator_args, and Airflow 3 compatibility details.
Before starting, confirm: (1) dbt engine = Fusion (not Core → use cosmos-dbt-core), (2) warehouse = Snowflake, Databricks, Bigquery and Redshift only.
Fusion-Specific Constraints
| Constraint | Details |
|---|---|
| No async | AIRFLOW_ASYNC not supported |
| No virtualenv | Fusion is a binary, not a Python package |
| Warehouse support | Snowflake, Databricks, Bigquery and Redshift support while in preview |
1. Confirm Cosmos Version
CRITICAL: Cosmos 1.11.0 introduced dbt Fusion compatibility.
# Check installed version
pip show astronomer-cosmos
# Install/upgrade if needed
pip install "astronomer-cosmos>=1.11.0"
Validate: pip show astronomer-cosmos reports version ≥ 1.11.0
Sponsors
Details
- Repository
- github.com/astronomer/agents
- Category
- Databases
- First seen
- May 16, 2026
More from astronomer/agents
All 24- Warehouse Init841
- Deploying Airflow817
- Troubleshooting Astro Deployments655
- Airflow Plugins622
- Managing Astro Deployments595
- Blueprint584
- Init176
- Managing Astro Local Env1.6K
- Airflow1.5K
- Analyzing Data1.4K
- Authoring Dags1.3K
- Debugging Dags1.2K
- Testing Dags1.2K
- Migrating Airflow 2 To 31.1K
- Setting Up Astro Project1.1K
- Tracing Upstream Lineage1.1K
- Profiling Tables1.1K
- Tracing Downstream Lineage1.1K
- Checking Freshness1K
- Annotating Task Lineage1K
- Cosmos Dbt Core990
- Airflow Hitl980
- Creating Openlineage Extractors960