Skip to main content

Deterministic evidence and control-regression gating for AI agents and the SAP, web and Citrix systems they drive. Record once, replay with zero LLM calls.

Project description

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: early, in active development (v0.2). 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

Project details


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.10.0.tar.gz (595.6 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.10.0-cp39-abi3-win_amd64.whl (9.3 MB view details)

Uploaded CPython 3.9+Windows x86-64

flowproof-0.10.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (8.1 MB view details)

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

flowproof-0.10.0-cp39-abi3-macosx_11_0_arm64.whl (7.3 MB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

File details

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

File metadata

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

File hashes

Hashes for flowproof-0.10.0.tar.gz
Algorithm Hash digest
SHA256 2182a60379418b68d2fbf4f0dc614e5d38d7946bb6b4f2bbdfa4bcee01c601bc
MD5 31d1cb443fea53bbecbff1bb15196191
BLAKE2b-256 c855886b4d7977be1efa9458d03a3bddc6c274518fbd5ee5c03b38194c2f57b3

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: flowproof-0.10.0-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 9.3 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.10.0-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 111beccc7a4a49488c09945a13b2d60d6690ab8b4a4bf743972c49044b18649f
MD5 15256073497196ed3eb010e701e1e06d
BLAKE2b-256 14caa27cd9e77a9aff73f91459bfc828a64a37cf92293d4b1293e66efcae45bb

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.10.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a80c3cfee16242ef85a6634c69bdba864019268ed2e0bc0318238fad1554f380
MD5 13d0146b324187796fd5d9a39a469a1a
BLAKE2b-256 112c98bc98057d976c1571c6eb1476771745002a2db02e6f3fde0f80b14a09d9

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.10.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3047b85fac915d2b2697c5afb6adc409f81618ecb8a513a1a7e4be1c3a0cec02
MD5 76174e9137fa18a337346602ccdebd59
BLAKE2b-256 70b2b7ddf41671ebab4741b21c230b52ba93bc6a6f798c285bbb9383b6fea99b

See more details on using hashes here.

Provenance

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