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

Uploaded CPython 3.9+Windows x86-64

flowproof-0.11.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.11.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.11.0.tar.gz.

File metadata

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

File hashes

Hashes for flowproof-0.11.0.tar.gz
Algorithm Hash digest
SHA256 e5b88070c9a59aee13e4fde49597504fb4ca4609d2d3ffd63ef927ae3b18c076
MD5 cc48bb21370fbfe935c168c64b6877df
BLAKE2b-256 5a2b9dffbffa84b608d2a900c1230398fd3f8b573eff35d4dab44b94c7558ea2

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: flowproof-0.11.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.11.0-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 919120a82b1a8017bf6f3aa1cfb9045de758a7c85feffba72545c2cacba86481
MD5 57b4348c195a58cae08e8bdef8142d68
BLAKE2b-256 ae7a540216f0c6aaa5632ad3a46255ff665262ea65f718f59435a59322b114ec

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.11.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 48dc3f97320916df940663d47486039448161ab943e134b8e7e3b77969aace7d
MD5 ad37acafb430531d3e870ac37c63e63a
BLAKE2b-256 f3c2e40ad5d1cefa53d26e0fe3efac9b43e01f6844589951ac130be3d58d79ca

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.11.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e6f6af70ae75fec75d35f2bcdea2ae2803105e1bf1d5bfee85ed5f9a33a92edf
MD5 9345d5d9a8589281fb13c6f1c2793a14
BLAKE2b-256 fc97b9290d16fcc12e33d7436ac85f6fe3643764ec5fca39011e3ee0bc5e93e2

See more details on using hashes here.

Provenance

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