---
title: "astronomer-cosmos | pypx"
description: "Orchestrate your dbt projects in Airflow"
canonical_url: "https://pypx.app/packages/astronomer-cosmos"
meta:
  "og:description": "Orchestrate your dbt projects in Airflow"
  "og:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_astronomer-cosmos%2Cversion_1.16.0%2Csummary_Orchestrate%2Byour%2Bdbt%2Bprojects%2Bin%2BAirflow%2Clicense_Apache-2.0%2Cp_Ii9wYWNrYWdlcy9hc3Ryb25vbWVyLWNvc21vcyI%2Cs_tWl8GDlWNgsKMdUo.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "astronomer-cosmos 1.16.0"
  "twitter:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_astronomer-cosmos%2Cversion_1.16.0%2Csummary_Orchestrate%2Byour%2Bdbt%2Bprojects%2Bin%2BAirflow%2Clicense_Apache-2.0%2Cp_Ii9wYWNrYWdlcy9hc3Ryb25vbWVyLWNvc21vcyI%2Cs_tWl8GDlWNgsKMdUo.png"
---

> Index of every page on this site: [llms.txt](https://pypx.app/llms.txt)

# **astronomer-cosmos**

v1.16.0

Orchestrate your dbt projects in Airflow

302 KB Python 3.11+ py3-none-anyApache-2.09 deps

[** Diff **](https://pypx.app/packages/astronomer-cosmos/diff)

`$ uv add astronomer-cosmos`

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

[![License](https://img.shields.io/:license-Apache%202-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0.txt) [![PyPI version](https://badge.fury.io/py/astronomer-cosmos.svg)](https://badge.fury.io/py/astronomer-cosmos) [![Python versions](https://img.shields.io/pypi/pyversions/astronomer-cosmos.svg)](https://pypi.org/project/astronomer-cosmos/) [![PyPI downloads](https://img.shields.io/pypi/dm/astronomer-cosmos)](https://pypi.org/project/astronomer-cosmos/)

[![Contributors](https://img.shields.io/github/contributors/astronomer/astronomer-cosmos)](https://github.com/astronomer/astronomer-cosmos/graphs/contributors) [![Commit activity](https://img.shields.io/github/commit-activity/m/astronomer/astronomer-cosmos)](https://github.com/astronomer/astronomer-cosmos/commits/main) [![Slack #airflow-dbt](https://img.shields.io/badge/slack-%23airflow--dbt-white.svg?logo=slack&style=social)](https://apache-airflow.slack.com/archives/C059CC42E9W) [![LFX Health Score](https://insights.linuxfoundation.org/api/badge/health-score?project=astronomer-astronomer-cosmos)](https://insights.linuxfoundation.org/project/astronomer-astronomer-cosmos)

[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/astronomer/astronomer-cosmos/main.svg)](https://results.pre-commit.ci/latest/github/astronomer/astronomer-cosmos/main) [![Build main](https://github.com/astronomer/astronomer-cosmos/actions/workflows/test.yml/badge.svg)](https://github.com/astronomer/astronomer-cosmos/actions)

Run your dbt Core projects as [Apache Airflow®](https://airflow.apache.org/) 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.

##### Quickstart

Check out the Getting Started guide on our [docs](https://astronomer.github.io/astronomer-cosmos/getting_started/index.html). See more examples at [/dev/dags](https://github.com/astronomer/astronomer-cosmos/tree/main/dev/dags) and at the [cosmos-demo repo](https://github.com/astronomer/cosmos-demo).

##### Example Usage

You can render a Cosmos Airflow DAG using the DbtDag class. Here's an example with the [jaffle\_shop project](https://github.com/dbt-labs/jaffle_shop):

.. This renders on Github but not Sphinx:

https://github.com/astronomer/astronomer-cosmos/blob/24aa38e528e299ef51ca6baf32f5a6185887d432/dev/dags/basic\_cosmos\_dag.py#L1-L42

This will generate an Airflow DAG that looks like this:

##### Community

- Join us on the Airflow [Slack](https://apache-airflow.slack.com/archives/C059CC42E9W) at #airflow-dbt

##### Changelog

We follow [Semantic Versioning](https://semver.org/) for releases. Check [CHANGELOG.rst](https://github.com/astronomer/astronomer-cosmos/blob/main/CHANGELOG.rst) for the latest changes.

##### Contributing Guide

All contributions, bug reports, bug fixes, documentation improvements, enhancements are welcome.

A detailed overview an how to contribute can be found in the [Contributing Guide](https://astronomer.github.io/astronomer-cosmos/policy/contributing).

As contributors and maintainers to this project, you are expected to abide by the [Contributor Code of Conduct](https://github.com/astronomer/astronomer-cosmos/blob/main/CODE_OF_CONDUCT.md).

##### License

[Apache License 2.0](https://github.com/astronomer/astronomer-cosmos/blob/main/LICENSE)

##### Privacy Notice

The application and this website collect telemetry to support the project's development. These can be disabled by the end-users.

Read the [Privacy Notice](https://github.com/astronomer/astronomer-cosmos/blob/main/PRIVACY_NOTICE.rst) to learn more about it.

##### Related Repositories

The core Astronomer Cosmos library is developed in this repository ([astronomer-cosmos](https://github.com/astronomer/astronomer-cosmos)). The following additional repositories are maintained as part of the Astronomer Cosmos project:

- [cosmos-demo](https://github.com/astronomer/cosmos-demo) - Example DAGs and demo project for Cosmos

At this time, Cosmos has no other subprojects or additional repositories beyond the one listed above.

## Security Policy

Check the project's [Security Policy](https://github.com/astronomer/astronomer-cosmos/blob/main/SECURITY.rst) to learn how to report security vulnerabilities in Astronomer Cosmos and how security issues reported to the Astronomer Cosmos security team are handled.

## **Details **

<dl>

<dt>Version</dt>
<dd>1.16.0</dd>

<dt>License</dt>
<dd>Apache-2.0</dd>

<dt>Python</dt>
<dd>&gt;=3.11</dd>

<dt>Maintainer</dt>
<dd>Astronomer &lt;humans@astronomer.io&gt;</dd></dl>

## **Links**

- [Documentation](https://astronomer.github.io/astronomer-cosmos)
- [Homepage](https://github.com/astronomer/astronomer-cosmos)
- [Source code](https://github.com/astronomer/astronomer-cosmos)
- [View on PyPI](https://pypi.org/project/astronomer-cosmos/)

## **Release Cadence **

**50**

releases in the past year

avg 7 days between releases

## **Maintainers **

- Astronomer · [humans@astronomer.io](mailto:humans@astronomer.io)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://pypx.app/#website","@type":"WebSite","description":"The Python Package Index, reimagined. Fast search, dependency insights, download trends, and changelogs — all in one place.","name":"pypx","url":"https://pypx.app/"},{"@id":"https://pypx.app/packages/astronomer-cosmos#webpage","@type":"WebPage","description":"Orchestrate your dbt projects in Airflow","name":"astronomer-cosmos","url":"https://pypx.app/packages/astronomer-cosmos","isPartOf":{"@id":"https://pypx.app/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://pypx.app/packages/astronomer-cosmos"]}]},{"@id":"https://pypx.app/packages/astronomer-cosmos#/schema/software-application/1","@type":"SoftwareApplication","applicationCategory":"DeveloperApplication","description":"Orchestrate your dbt projects in Airflow","license":"Apache-2.0","name":"astronomer-cosmos","softwareVersion":"1.16.0"}]}
```

## Sitemap

See the full [sitemap](https://pypx.app/sitemap.md) for all pages.
