Skip to content

Releases: mrzroot/flowpilot

Release list

flowpilot v0.1.0

flowpilot v0.1.0 Latest
Latest

Choose a tag to compare

View all tags
@mrzroot mrzroot released this 08 Oct 10:33
v0.1.0
f3c31d6

First public release of flowpilot — a lightweight, self-hosted, code-first workflow automation engine for Python with first-class Telegram support.

Install

pipx install "git+https://github.com/mrzroot/flowpilot.git@v0.1.0"
# or download the wheel below:
pipx install ./flowpilot-0.1.0-py3-none-any.whl
flowpilot init my-automations && cd my-automations && flowpilot serve

flowpilot is not published on PyPI; install from GitHub or from the assets attached to this release.

Highlights

  • Engine: asyncio workflow engine with sequential steps, per-step and per-workflow
    timeouts, retries with exponential backoff, if conditions, for_each loops,
    continue_on_error, on_failure handlers, per-workflow concurrency limits and
    persistent per-workflow state.
  • Triggers: cron (with time zones), interval, webhook (shared secret or GitHub
    X-Hub-Signature-256), file (polling watcher), feed (RSS/Atom, one run per new
    entry) and manual.
  • Steps: http, telegram (messages, long-message splitting, documents, photos,
    any Bot API method, custom API base), email (SMTP), transform (Jinja2 / JMESPath),
    condition, branch, delay, log, python, shell (opt-in), file.write,
    file.read, sqlite, state, archive (tar.gz/zip with retention).
  • Templates: sandboxed Jinja2 with native-value rendering and filters including
    jmespath, number, tojson, md_escape, jalali (Persian calendar) and fa_digits.
  • Workflows in YAML or Python (flowpilot.define), with static validation of step
    types and parameters.
  • Plugins: @step decorator, plugins: setting and the flowpilot.steps entry point group.
  • Server: FastAPI REST API, webhooks, Server-Sent Events, optional bearer-token auth,
    OpenAPI docs at /api/docs.
  • Dashboard: dependency-free web UI with live run logs, run history, enable/disable,
    manual runs, workflow definitions and state; follows the system dark/light theme.
  • CLI: init, validate, list, run, serve, logs (with --follow), steps.
  • SQLite persistence (WAL) with automatic history pruning and crash recovery.
  • Example workflows, Dockerfile, docker-compose, CI on Python 3.10–3.12.

Verified

  • 150 tests, 96% line coverage; CI green on Python 3.10, 3.11 and 3.12 (ruff, ruff format, mypy, pytest, build + wheel smoke test).
  • Telegram delivery was exercised against a local mock of the Bot API; the Docker image was not built as part of this release.

Full documentation: README · Landing page: https://mrzroot.github.io/flowpilot/

Assets 4
Loading