waymark

What is waymark?

Waymark is an open source library designed to build durable background tasks in Python. It ensures workflows survive server restarts, task crashes, and long-running executions by storing state in Postgres. The project requires no additional infrastructure beyond a PostgreSQL database.

The system uses two core primitives: actions, which are distributed async functions that perform the actual work, and workflows, which provide durable control flow to orchestrate those actions. Developers can define retry policies, set timeouts, schedule tasks with cron or intervals, and integrate AI agents through a wrapper around pydantic-ai.

A built-in web application provides visibility into running workflows and execution nodes. The library ships as a single Python package containing both client and server binaries, making it straightforward to install and run locally or in production environments.

waymark features

• Durable execution that survives server restarts and crashes
• Postgres-backed state storage with no extra infrastructure
• Action and workflow primitives for distributed task orchestration
• Configurable retry policies and per-call timeouts
• Cron and interval-based scheduled workflows
• Built-in web dashboard for monitoring workflows and nodes
• Native integration wrapper for pydantic-ai agents

Who uses waymark and for what

• Sending personalized welcome emails to filtered user batches
• Processing large datasets with parallel fan-out operations
• Running long-running data pipelines that require crash recovery
• Scheduling recurring maintenance tasks across multiple servers
• Orchestrating AI agent calls with reliable fallback and retry logic

waymark FAQ

Comments (0)

Comments and upvotes open when this product launches on ProductPerch.