Stardag

Declarative and composable DAGs for Python.

Stardag provides a clean Python API for representing persistently stored assets, the code that produces them, and their dependencies as a declarative Directed Acyclic Graph (DAG). It is a spiritual—but highly modernized—descendant of Luigi, designed for iterative data and ML workflows.

Built on Pydantic, Stardag uses expressive type annotations to reduce boilerplate and make task I/O contracts explicit—enabling composable tasks and pipelines while maintaining a fully declarative specification of every produced asset.

Quick Example

import stardag as sd

@sd.task
def get_range(limit: int) -> list[int]:
    return list(range(limit))

@sd.task
def get_sum(integers: sd.Depends[list[int]]) -> int:
    return sum(integers)

# Declarative DAG specification - no computation yet
sum_task = get_sum(integers=get_range(limit=4))

# Materialize all tasks' targets
sd.build(sum_task)

# Load results
assert sum_task.load() == 6
assert sum_task.integers.load() == [0, 1, 2, 3]

Installation

pip install stardag

Or with uv:

uv add stardag

Optional extras:

pip install stardag[s3]      # S3 storage support
pip install stardag[prefect] # Prefect integration
pip install stardag[modal]   # Modal integration

Documentation

Read the docs for tutorials, guides, and API reference.

Getting Started — Installation and first steps
Core Concepts — Tasks, targets, dependencies
How-To Guides — Integrations with Prefect, Modal
Configuration — Profiles, CLI reference

Stardag Cloud

Stardag Cloud provides optional services for team collaboration and monitoring:

Web UI — Dashboard for build monitoring and task inspection
API Service — Task tracking and coordination across distributed builds

The SDK works fully standalone—the platform adds value for teams needing shared visibility and coordination.

Why Stardag?

Composability — Task instances as first-class parameters enable loose coupling and reusability
Declarative — Full DAG specification before execution; inspect, serialize, and reason about pipelines
Deterministic — Parameter hashing gives each task a unique, reproducible ID and output path
Pydantic-native — Tasks are Pydantic models with full validation and serialization support
Framework-agnostic — Integrate with Prefect, Modal, or run standalone

Release files for stardag 0.27.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for stardag 0.27.0
File	Size	Uploaded
stardag-0.27.0.tar.gz	849.3 kB	Sep 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for stardag 0.27.0
File	Interpreter	ABI	Platform	Reset
stardag-0.27.0-py3-none-any.whl 464.2 kB Sep 25, 2026	Python 3	none	any	Details

Total release size: 1.3 MB

Release files / stardag-0.27.0.tar.gz

Download URL	stardag-0.27.0.tar.gz
Size	849.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`59decf4d849635892589c19577c70064a74f6203f38708dfb2d9722f255f8ed0`
BLAKE2b-256 checksum How to use checksums	`046c68a4910c31f5809a0b47c7f5c7f280c9cb42f80ad438b26140d028e561ee`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/stardag-dev/stardag
Publishing commit: github.com/stardag-dev/stardag/tree/910cd6074a3841bf339c0c273ff2600b30f5feb9

Workflow

Publishing configuration: github.com/stardag-dev/stardag/blob/910cd6074a3841bf339c0c273ff2600b30f5feb9/.github/workflows/publish.yml
Publishing logs: github.com/stardag-dev/stardag/actions/runs/36137536886/attempts/1

Artifact

Subject: stardag-0.27.0.tar.gz
SHA-256 checksum: 59decf4d849635892589c19577c70064a74f6203f38708dfb2d9722f255f8ed0 Verifying attestations

Release files / stardag-0.27.0-py3-none-any.whl

Download URL	stardag-0.27.0-py3-none-any.whl
Size	464.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9945f5f360ea29befefdf202d4b9d2094ba49f562a927b586e0d93a0021ebc67`
BLAKE2b-256 checksum How to use checksums	`4eebb066cc6ea316f01fa806a52de7d9f7f0c5ba66784bc613de95cec270a2bf`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/stardag-dev/stardag
Publishing commit: github.com/stardag-dev/stardag/tree/910cd6074a3841bf339c0c273ff2600b30f5feb9

Workflow

Publishing configuration: github.com/stardag-dev/stardag/blob/910cd6074a3841bf339c0c273ff2600b30f5feb9/.github/workflows/publish.yml
Publishing logs: github.com/stardag-dev/stardag/actions/runs/36137536886/attempts/1

Artifact

Subject: stardag-0.27.0-py3-none-any.whl
SHA-256 checksum: 9945f5f360ea29befefdf202d4b9d2094ba49f562a927b586e0d93a0021ebc67 Verifying attestations