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.
  • To install pip, a Python package installer

Installing dg​

To optimize your Dagster experience, we recommend using dg—a tool that streamlines the Dagster development workflow and works seamlessly with any Python package manager.

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

brew install uv

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

Although you can create a virtual environment and install dagster-dg using uv, we recommend a global installation for most users. It's simpler, requires only a one-time setup, and offers better support across multiple Python projects.

Verifying dg installation​

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

> dg --version
dg, version 0.26.11

Initializing a Dagster project​

Once dg is installed (assuming a global installation), it can manage virtual environments for your Dagster projects. To get started, open your terminal and run:

dg init my-project && cd my-project

bash source .venv/bin/activate

This command will install the core Dagster library and the webserver, which is used to serve the Dagster UI.

Verifying dagster installation​

To confirm that Dagster is installed correctly, run the following command from within your virtual environment. You should see Dagster's version numbers printed in the terminal:

> dagster --version
dagster, version 1.10.11

Troubleshooting​

If you encounter any issues during the installation process:

Next steps​