Skip to main content

flowproof

Run your AI agent once, keep the recording, and assert against it from then on. flowproof captures the run at the model boundary - every request and every tool-call decision - and serves it back on later runs, so replay makes zero LLM calls. You assert which tools were called, with which arguments, in which order, and which were not. The same engine drives web, desktop and Citrix.

Agents author, a deterministic engine executes. A flow is described in YAML with natural-language steps, recorded once against the live app, and replayed deterministically in CI with zero LLM calls. Built agent-native: every operation returns structured results a program can reason over, and agents can drive record/run/get_trace/heal over MCP (pip install flowproof[mcp], run flowproof-mcp).

# calc.flow.yaml
name: Add two numbers
app: calc
steps:
  - Type 5
  - Press plus
  - Type 3
  - Press equals
  - assert: display shows 8
from flowproof import Flow

flow = Flow("calc.flow.yaml")
flow.record()            # performs the flow live, writes the trace
result = flow.run()      # deterministic replay -> RunResult
assert result.passed

Or from the shell: flowproof record calc.flow.yaml, then flowproof run calc.flow.yaml (add --json for the structured report).

The wheel bundles the Rust engine; no separate install. Targets: web (headless Chromium, any OS), Windows desktop via UI Automation, sap (SAP GUI Scripting), vision (pixels-only for Citrix/RDP), and api (no UI — HTTP/SQL assertion flows, any OS).

Status: pre-alpha, in active development. Record→replay, model-grounded authoring, healing with reviewable diffs, suites, run recordings, and the MCP server all work and are tested in CI.

Docs and source: github.com/automators-com/flowproof

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flowproof-0.14.0.tar.gz (791.2 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

flowproof-0.14.0-cp39-abi3-win_amd64.whl (9.6 MB view details)

Uploaded CPython 3.9+Windows x86-64

flowproof-0.14.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (8.4 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.17+ x86-64

flowproof-0.14.0-cp39-abi3-macosx_11_0_arm64.whl (7.6 MB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

File details

Details for the file flowproof-0.14.0.tar.gz.

File metadata

  • Download URL: flowproof-0.14.0.tar.gz
  • Upload date:
  • Size: 791.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flowproof-0.14.0.tar.gz
Algorithm Hash digest
SHA256 1f84313f61e3780b2da1cbb6218929f6ac93ff00948addef0be986032d2e00d7
MD5 4a69871f3e966234f0aa60fefebd4892
BLAKE2b-256 b0d16cb682d04569c98e375b33404ab367a93c5fbd8522afd5378cf72fe8f36f

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.14.0.tar.gz:

Publisher: publish.yml on automators-com/flowproof

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file flowproof-0.14.0-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: flowproof-0.14.0-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.6 MB
  • Tags: CPython 3.9+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for flowproof-0.14.0-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 6f3431f284b069613d65e43d859593c81473eab15d6fb9351e8504a2a800b18b
MD5 a04f0d0c31d0b4d2aff1406735b7aab2
BLAKE2b-256 0a9c4d9247e77ef0636e9e06c6bb56396a0bb3d6fcac6953c8ca074b8b061ef3

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.14.0-cp39-abi3-win_amd64.whl:

Publisher: publish.yml on automators-com/flowproof

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file flowproof-0.14.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for flowproof-0.14.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 2ae1202e981fb49931730fecc30629f05d7a0fd2bd2ce87d841e7c8b688d41c0
MD5 9559465cedc6d8d7379063357a1c15c1
BLAKE2b-256 27bcc9c41880eeed8ed90622c8f469b7bf9395fa48b890ad7b7d122c40cb25f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.14.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish.yml on automators-com/flowproof

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file flowproof-0.14.0-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for flowproof-0.14.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b0d1061c17cc2bf2f7de84386044a00ecd9be13a6c7c9ecfe034118b974300dd
MD5 617962f9501288630f3e90d2ce3bbc6c
BLAKE2b-256 5255cf9d3aad45f7def5025b18c1858ac1750aaa37557744d0b2c75924fb057b

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.14.0-cp39-abi3-macosx_11_0_arm64.whl:

Publisher: publish.yml on automators-com/flowproof

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page