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

Uploaded CPython 3.9+Windows x86-64

flowproof-0.9.1-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.9.1-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.9.1.tar.gz.

File metadata

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

File hashes

Hashes for flowproof-0.9.1.tar.gz
Algorithm Hash digest
SHA256 3b09ee522630c0c3222400fc96a75f3ff3dee95dfb6439de4a800fcf0691e282
MD5 941c71acb3b32185bcc318855c2a78dc
BLAKE2b-256 7c55f5d834d8724ddaac085af92518c0a60bd5970eb866319673cf1624bd0fc1

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: flowproof-0.9.1-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.9.1-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 c76cfd0dfb482c58005af0e16bc1d783038f619d505ebdecf1602f6cafa1b161
MD5 403162aab972203ccb0ce70b2d1a81e1
BLAKE2b-256 b069e93d16a129c4233b712b23931b7344678eff09465565635833ac653eccb2

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.9.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 ec563751dbc974f082df167c8453e108b37c31b3d2dd1c5483e1e0633b9c5b21
MD5 c9c5b29c93285f3ed2a5f0b8ad43d093
BLAKE2b-256 49b65d44d714cc56424a20753efba7934fa0654510dfc4ae0bd6baa1c3e9d092

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.9.1-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bbe292be962bc573e9fd268f162041a09ae332e19f21abb0a65f61a3bb802355
MD5 0292aa686138b7b0c2f9f3011d3a6570
BLAKE2b-256 2ea4b515c829d5261f9d2ae36ac6692102739d722c936563788d8f5045e00435

See more details on using hashes here.

Provenance

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