piercefreeman/waymark

Что это?

Ключевые возможности

• 01Надёжные workflow, которые после сбоев или перезапусков возобновляются с сохранённого состояния
• 02Действия выполняются на распределённых рабочих узлах; для отдельных вызовов можно задать политики повторных попыток и тайм-ауты
• 03Обычные конструкции Python: циклы, условия и asyncio.gather для параллельного выполнения
• 04Надёжная задержка, сохраняющаяся после перезапусков, — от нескольких секунд до нескольких дней
• 05Расписания cron и с заданным интервалом без дополнительной инфраструктуры
• 06Встроенное веб-приложение для просмотра экземпляров workflow и нагрузки на узлы

Сценарии использования

• Рассылка писем пакетами или вызов сторонних API с повторными попытками и распределением задач
• Запуск заданий для работы с базами данных, которые должны надёжно завершаться даже при деплоях и сбоях
• Планирование периодической синхронизации данных без отдельного брокера задач
• Оркестрация многоэтапных асинхронных процессов в приложении на Python с Postgres

Быстрый старт

1. 1

   Установите пакет с помощью uv

   uv add waymark
2. 2

   Запустите node, подключенный к вашей базе данных Postgres, с включенным webapp

   export WAYMARK_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/waymark export WAYMARK_HTTP_ENABLED=true uv run waymark-executor

Что важно знать

• !В README рекомендуется пока не использовать проект в production: спецификация быстро меняется, а обратная совместимость до версии 1.0.0 не гарантируется.
• !На данный момент поддерживается только Python.
• !Не подходит для чувствительных к задержкам задач, требующих обработки менее чем за 100 мс, или координации более примерно 10 тысяч действий одновременно.

Темы

Частые вопросы

Что такое waymark?

Библиотека Python для надёжных фоновых процессов и действий, переживающих перезапуски и сбои; единственная инфраструктурная зависимость — Postgres. Waymark — библиотека для фоновых задач, которые продолжают выполняться после перезапуска сервера, сбоев задач и во время длительных операций. Единственная инфраструктурная зависимость — Postgres, а первым поддерживаемым языком стал Python. Вы описываете действия обычными асинхронными функциями Python: они выполняются на распределённых рабочих узлах. Затем создаёте workflow, который управляет ими с помощью стандартных конструкций языка — циклов, условий и параллельных ветвей.

waymark можно использовать бесплатно? Какая у него лицензия?

waymark распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

waymark всё ещё поддерживается?

Активно поддерживается. Последний коммит в waymark — 6 нояб. 2026 г..

Для чего можно использовать waymark?

Рассылка писем пакетами или вызов сторонних API с повторными попытками и распределением задач Запуск заданий для работы с базами данных, которые должны надёжно завершаться даже при деплоях и сбоях Планирование периодической синхронизации данных без отдельного брокера задач Оркестрация многоэтапных асинхронных процессов в приложении на Python с Postgres

Как установить waymark?

Установите пакет с помощью uv: uv add waymark Запустите node, подключенный к вашей базе данных Postgres, с включенным webapp: export WAYMARK_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/waymark export WAYMARK_HTTP_ENABLED=true uv run waymark-executor

Где скачать waymark?

Исходный код и инструкции по установке — на GitHub: https://github.com/piercefreeman/waymark