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

Uploaded CPython 3.9+Windows x86-64

flowproof-0.10.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.10.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.10.1.tar.gz.

File metadata

  • Download URL: flowproof-0.10.1.tar.gz
  • Upload date:
  • Size: 599.4 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.1.tar.gz
Algorithm Hash digest
SHA256 66cfd1efdf40212772e9a5d31a711c7bf7a30d9e841efeb250e63292f7bffdc5
MD5 dafb67af24b8f387e5bbb57fe60365c8
BLAKE2b-256 d153ac6f94ca09a6835a2a7f4e685f142676bee17fae9d5bbcba99475e5ad6ad

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: flowproof-0.10.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.10.1-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 068a13eedfe855a25cbad82e3763c774470635c0966fcedef5ce7f09c49dff8d
MD5 ba42afcd5e4b7e3a5ee597c4bb6ca560
BLAKE2b-256 4b007f0a3e6fb042be88895dea96b72d34e9b7185918d2011a32b085e5c167b3

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.10.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d3fbbdf1c5ab2659e40ed1e523772ae57e111521f4cf0162e2858700ffadb700
MD5 51f1dc8877010023500df9dc3fe3ca97
BLAKE2b-256 0d1910f4af714ef152bc9590404835571d7b594c76a4cd3c4729a6e8247acf3b

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for flowproof-0.10.1-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 33894531897611cf32cc8fabd16ac50e1c867f04fdb4e0c8d2b09a0b140e8585
MD5 b2366ab373047fe3d4686fb12cc0e4ab
BLAKE2b-256 96e235757bbd889cf7afb61b4d939538f6cb9333c84a1adda0730a8a283fc55e

See more details on using hashes here.

Provenance

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