Skip to main content

Installing Dagster

To follow the steps in this guide, you'll need:

  • To install Python 3.9 or higher. Python 3.12 is recommended.

The recommended way to get started with Dagster is to create a project using the create-dagster command line utility. This will scaffold a Dagster project with our recommended structure and required dependencies.

Using create-dagster​

The create-dagster utility can be installed with Homebrew or curl, or invoked without installation using uvx.

First, install the Python package manager uv if you don't have it.

This will also install the uvx command, which allows you to execute commands without having to install packages directly.

brew install uv

For more detailed uv installation instructions, see the uv docs.

Now, you can run the create-dagster command using uvx:

uvx create-dagster project my-project

Alternative: Manual installation in a virtual environment​

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.

Installing Dagster​

uv add dagster dagster-webserver dagster-dg-cli

Verifying your project​

To verify that Dagster is installed correctly, run the following command:

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

You should be presented with the version number of dg in your environment.

Troubleshooting​

If you encounter any issues during the installation process:

Next steps​