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.12.1.tar.gz (723.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.12.1-cp39-abi3-win_amd64.whl (9.5 MB view details)

Uploaded CPython 3.9+Windows x86-64

flowproof-0.12.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (8.2 MB view details)

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

flowproof-0.12.1-cp39-abi3-macosx_11_0_arm64.whl (7.5 MB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: flowproof-0.12.1.tar.gz
  • Upload date:
  • Size: 723.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.12.1.tar.gz
Algorithm Hash digest
SHA256 4698f3efca941d4f44e5edcc71c0415bc7349888355aa9c428751e762cca268c
MD5 04acc833f669eabc5d1c2c00588907da
BLAKE2b-256 c336fc098402cded59447ae8c3cf144b9560f529038e772ce6a2f707a97a7ded

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.12.1.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.12.1-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: flowproof-0.12.1-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.5 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.12.1-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 7fc04d8cd50b6d11bb334822b3fa343ade36982891a369e2ea811bcf4cd11f5c
MD5 60305c5e9a805523272da4b80ae8f0e4
BLAKE2b-256 fd5b88fa8adab4161c1ce2d4a3c75fb89011d480402428401679787dcac03108

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.12.1-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.12.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for flowproof-0.12.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 6a8914cb3c5eb080e9fd11869e269b8777749f41b9e4b5aae8908c1ce7e96098
MD5 dd01b00abdb332483aabd16f1f13be7a
BLAKE2b-256 71faf1b9ea2452eba0b4897e6591f07bc5f018eb2f4871650ce9717aa2632b25

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.12.1-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.12.1-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for flowproof-0.12.1-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 61fe64df612ca35d65ddb20ede0bab6d05eabd76d98580a5e426a5b1d8e172be
MD5 289d1cca7598e8846f326e971469cb5b
BLAKE2b-256 f9371c41f17464817b8c5237708a86c3f18e747fb00bafc17f979ea4a55522c7

See more details on using hashes here.

Provenance

The following attestation bundles were made for flowproof-0.12.1-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