Welcome to Dotflow! 🎲

[FernandoCelmer]

Welcome to Dotflow

Hey everyone! Thanks for checking out Dotflow.

What is Dotflow?

Dotflow is a lightweight Python library for building execution pipelines. No infrastructure required — no Redis, no RabbitMQ, no Postgres. Just pip install dotflow and you're ready to go.

from dotflow import DotFlow, action

@action
def extract():
    return {"users": 150}

@action
def transform(previous_context):
    return {"active": int(previous_context.storage["users"] * 0.8)}

@action
def load(previous_context):
    print(f"Loaded {previous_context.storage['active']} active users")

workflow = DotFlow()
workflow.task.add(step=extract)
workflow.task.add(step=transform)
workflow.task.add(step=load)
workflow.start()

What can you do with it?

• 4 execution modes — sequential, parallel, background, and parallel groups
• Built-in resilience — retry, exponential backoff, and timeout per task
• Context chain — pass data between tasks automatically
• Checkpoint & resume — pick up where you left off after a failure
• Cron scheduler — run workflows on a schedule with overlap strategies (skip, queue, parallel)
• Storage providers — in-memory, file, AWS S3, Google Cloud Storage
• Notifications — Telegram integration out of the box
• Async support — works with async functions natively
• CLI — run workflows from the command line
• Class-based steps — organize complex logic into classes with multiple @action methods

Who is it for?

Dotflow is for anyone who needs pipelines in Python without the overhead of heavy orchestrators like Airflow or Prefect. Think:

• ETL scripts and data pipelines
• Automation workflows
• Microservice task orchestration
• CLI tools with multi-step processes
• Prototyping and personal projects

Get started

• Documentation
• PyPI
• Examples

Get involved

We'd love your feedback and contributions:

• Open an issue for bugs or feature requests
• Check out issues labeled good first issue if you want to contribute
• Share your ideas in the Ideas category
• Show what you built in Show and tell

Thanks for being here!