acyro 0.1.1

A small Python-native DAG task executor with caching.

Acyro

English | 简体中文

A small, local, Python-native DAG task runner with deterministic execution and JSON caching.

Install

pip install acyro

Requires Python 3.12 or newer.

Quick start

from acyro import run, task


@task
def download() -> None:
    print("download")


@task(depends=[download])
def build() -> None:
    print("build")


run()

run() executes tasks in dependency order. Later runs skip unchanged tasks.

CLI

Put tasks in a Python file, then run or inspect the graph:

acyro run examples/acyrofile.py
acyro graph examples/acyrofile.py

Cache

Successful tasks are cached under .acyro/cache. Fingerprints include task metadata, source code, and dependency fingerprints, so dependency changes invalidate downstream tasks. Use run(cache_dir=...) to choose another cache directory.

Acyro is intentionally serial and local. It has no async runtime, distributed workers, database, retries, or pluggable cache backends.

Development

uv sync --extra dev
uv run pytest -q
uv run ruff check .
uv build

Licensed under the MIT License.