Installing Dagster

note

To follow the steps in this guide, you'll need to install Python 3.10 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
• Installation requirements for manually creating or updating a project

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.

uv (Recommended)

Install the Python package manager uv:

Mac

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c 'irm https://astral.sh/uv/install.ps1 | iex'

Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

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

Homebrew

The create-dagster command line utility is available in a Homebrew tap:

brew install dagster-io/tap/create-dagster

After installation, you can run the create-dagster command:

create-dagster project my-project

curl

Use curl to download a standalone installation script for the create-dagster command line utility and execute it with sh:

curl -LsSf https://dg.dagster.io/create-dagster/install.sh | sh

After installation, you can run the create-dagster command:

create-dagster 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

uv add dagster dagster-webserver dagster-dg-cli

pip

pip install 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.

If you scaffolded your project with uvx create-dagster, a virtual environment was created and dependencies were installed automatically by uv sync, so you only need to activate it. If you installed create-dagster with pip, brew, or curl, you must create the virtual environment yourself and install the scaffolded project into it before dg becomes available.

uv

Mac

cd my-project

source .venv/bin/activate

dg --version

Windows

cd my-project

.venv\Scripts\activate

dg --version

Linux

cd my-project

source .venv/bin/activate

dg --version

pip / brew / curl

Mac

cd my-project

python -m venv .venv

source .venv/bin/activate

pip install --editable . --group dev

dg --version

Windows

cd my-project

python -m venv .venv

.venv\Scripts\activate

pip install --editable . --group dev

dg --version

Linux

cd my-project

python -m venv .venv

source .venv/bin/activate

pip install --editable . --group dev

dg --version

note

The --group argument requires pip 25.1 or higher. On older pip, upgrade with pip install --upgrade pip, or omit --group dev and install the CLI separately with pip install dagster-dg-cli.

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