Skip to main content

Installing Dagster

note

To follow the steps in this guide, you'll need to install Python 3.9 or higher. Python 3.13 is recommended.

To get started with Dagster, you can scaffold a new project with the create-dagster CLI (recommended), manually create a new project, or update an existing project to install Dagster dependencies.

Installation requirements for using the create-dagster CLI​

If you're just getting started with Dagster, we recommend scaffolding a new project with the create-dagster command line utility, which will generate a Dagster project with our recommended structure and required dependencies.

Install the Python package manager uv:

brew install uv

Installing uv will install the uvx command, which allows you to execute commands without having to install packages directly. You can run the create-dagster command using uvx:

uvx create-dagster@latest project my-project

Installation requirements for manually creating or updating a project​

If you prefer to set up Dagster manually or are installing it into an existing project, you can install Dagster directly into your Python environment:

uv add dagster dagster-webserver dagster-dg-cli

Verifying your Dagster installation​

To verify that Dagster is installed correctly, run the commands below. You should see the version number of dg in your environment.

cd my-project
source .venv/bin/activate
dg --version

Troubleshooting​

If you run into trouble during the installation process, reach out to the Dagster community.

Next steps​

  • Follow the Quickstart to get up and running with a basic Dagster project
  • Follow the Tutorial to learn how to build a more complex ETL pipeline
  • Add assets to your Dagster project