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

Uploaded CPython 3.9+Windows x86-64

flowproof-0.12.2-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.2-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.2.tar.gz.

File metadata

  • Download URL: flowproof-0.12.2.tar.gz
  • Upload date:
  • Size: 734.0 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.2.tar.gz
Algorithm Hash digest
SHA256 300b01370ef86a0cd12c2b0e499ecce824d4ee2261917e1d75ff24c69c37eeff
MD5 a01e6acb7c08711df334146a40459e1d
BLAKE2b-256 0ae1678208754b5d5932b47375c6207bc33a17023e345205be91debaa9716e45

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: flowproof-0.12.2-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.2-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 a2aa13ec10f4254f6fe7a781fcf30cd931cda46fb2e48c9173dc14aa1ad6e10f
MD5 25348c087d68bef60bc599efd9f8749f
BLAKE2b-256 faaf39ad876077bb4ee8d2a82054a1fdb64635e5e4f914f7432110c70a96a1c6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.12.2-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7bf7e5c047f2c30df52f4cfa57e1a401e1030a9c4a359f10c87e7f54ec156eaa
MD5 2c88c46c6128541d9e68780c37f05e86
BLAKE2b-256 e2725611119f0b11b046d25a20bcb79cfbd978a7657066e75958831f146093bb

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.12.2-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 500cde588098a1a43b39b4762f95f8ba223e8f4810ba68e058e10c4d2199e374
MD5 db9ab1fb6eb0f8677092cc3e8a408ff8
BLAKE2b-256 20f9e3d20461610f84b94710f70b45626d29b3d4d13ad3a84e3def94a1cee8bf

See more details on using hashes here.

Provenance

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