astronomer/astronomer-cosmos: Run your dbt Core or dbt Fusion projects as Apache Airflow DAGs and Task Groups with a few lines of code

.. License badge .. |license| image:: https://img.shields.io/:license-Apache%202-blue.svg :target: https://www.apache.org/licenses/LICENSE-2.0.txt :alt: License

.. PyPI badges .. |fury| image:: https://badge.fury.io/py/astronomer-cosmos.svg :target: https://badge.fury.io/py/astronomer-cosmos :alt: PyPI version

.. |python| image:: https://img.shields.io/pypi/pyversions/astronomer-cosmos.svg :target: https://pypi.org/project/astronomer-cosmos/ :alt: Python versions

.. |downloads| image:: https://img.shields.io/pypi/dm/astronomer-cosmos :target: https://pypi.org/project/astronomer-cosmos/ :alt: PyPI downloads

.. Community badges .. |contributors| image:: https://img.shields.io/github/contributors/astronomer/astronomer-cosmos :target: https://github.com/astronomer/astronomer-cosmos/graphs/contributors :alt: Contributors

.. |commits| image:: https://img.shields.io/github/commit-activity/m/astronomer/astronomer-cosmos :target: https://github.com/astronomer/astronomer-cosmos/commits/main :alt: Commit activity

.. |slack| image:: https://img.shields.io/badge/slack-%23airflow--dbt-white.svg?logo=slack&style=social :target: https://apache-airflow.slack.com/archives/C059CC42E9W :alt: Slack #airflow-dbt

.. |health| image:: https://insights.linuxfoundation.org/api/badge/health-score?project=astronomer-astronomer-cosmos :target: https://insights.linuxfoundation.org/project/astronomer-astronomer-cosmos :alt: LFX Health Score

.. Dev tools badges .. |pre-commit| image:: https://results.pre-commit.ci/badge/github/astronomer/astronomer-cosmos/main.svg :target: https://results.pre-commit.ci/latest/github/astronomer/astronomer-cosmos/main :alt: pre-commit.ci status

.. Build status badges .. |build-main| image:: https://github.com/astronomer/astronomer-cosmos/actions/workflows/test.yml/badge.svg :target: https://github.com/astronomer/astronomer-cosmos/actions :alt: Build main

.. image:: https://raw.githubusercontent.com/astronomer/astronomer-cosmos/main/docs/_static/cosmos-logo.svg

===========================================================

|license| |fury| |python| |downloads|

|contributors| |commits| |slack| |health|

|pre-commit| |build-main|

Run your dbt Core projects as Apache Airflow® _ DAGs and Task Groups with a few lines of code. Benefits include:

• Run dbt projects against Airflow connections instead of dbt profiles
• Native support for installing and running dbt in a virtual environment to avoid dependency conflicts with Airflow
• Run tests immediately after a model is done to catch issues early
• Utilize Airflow's data-aware scheduling to run models immediately after upstream ingestion
• Turn each dbt model into a task/task group complete with retries, alerting, etc.

Check out the Getting Started guide on our docs _. See more examples at /dev/dags _ and at the cosmos-demo repo _.

Example Usage ___________________

You can render a Cosmos Airflow DAG using the `DbtDag class. Here's an example with the jaffle_shop project _:

• Join us on the Airflow Slack _ at #airflow-dbt

We follow Semantic Versioning _ for releases. Check CHANGELOG.rst _ for the latest changes.

A detailed overview an how to contribute can be found in the Contributing Guide _.

As contributors and maintainers to this project, you are expected to abide by the Contributor Code of Conduct _.

Apache License 2.0 _

Read the Privacy Notice _ to learn more about it.

The core Astronomer Cosmos library is developed in this repository (astronomer-cosmos _). The following additional repositories are maintained as part of the Astronomer Cosmos project:

• cosmos-demo _ - Example DAGs and demo project for Cosmos

Check the project's Security Policy `_ to learn how to report security vulnerabilities in Astronomer Cosmos and how security issues reported to the Astronomer Cosmos security team are handled.