.. _getting_started:

Getting started with Cosmos
===========================

.. toctree::
   :maxdepth: 0
   :hidden:

   self

Cosmos fundamentals
~~~~~~~~~~~~~~~~~~~

Learn the important concepts and key ideas for how Cosmos works with Airflow and dbt.

.. toctree::
   :maxdepth: 1
   :caption: Cosmos Fundamentals

   How Cosmos works <how-cosmos-works>
   Similar dbt and Apache Airflow® concepts <dbt-airflow-concepts>
   Cosmos core concepts <core-concepts>

Quickstart
~~~~~~~~~~

Run Cosmos in just a few minutes using a pre-configured demo, such as the `cosmos-demo <https://github.com/astronomer/cosmos-demo>`_.
These guides are an ideal place to start if you don't have a particular project that you want to try out, and just want walk through the process of setting up Cosmos, Airflow, and a dbt project to work together.

.. toctree::
   :maxdepth: 1
   :caption: Quickstart

   Open-source quickstart <oss-quickstart>
   Astro CLI quickstart <astro-cli-quickstart>

Bring your own project
~~~~~~~~~~~~~~~~~~~~~~

An example workflow for setting up Cosmos, depending on how you run Airflow. For guides that describe specific scenarios or platforms that you want to use, see the following:

.. toctree::
   :maxdepth: 1
   :caption: Bring your own project

   Get started with your dbt project <bring-your-own>
   Open-source Apache Airflow® <open-source>
   Astro <astro>
   Amazon Managed Workflows for Apache Airflow® (MWAA) <mwaa>
   Google Cloud Composer (GCC) <gcc>