Skip to content

Stepfork v0.1.0a3 - Documentation Fix Alpha

This alpha is functionally identical to v0.1.0a2. It exists to correct the description rendered on the PyPI project page.

Why this release exists

PyPI renders the project description from the README captured in the published package metadata. The 0.1.0a2 package was built before the README was updated, so the PyPI page still showed "not on PyPI" text and a GitHub-only install command. PyPI release files are immutable, so the fix is a new version rather than an edit.

What changed

  • The README now leads with pip install --pre stepfork, with the GitHub tag install kept as an alternative.
  • The "not on PyPI yet" statements were removed.
  • The logo and workflow diagram use absolute image URLs so both render on the PyPI project page.
  • The quickstart states that pytest is required to run the exported regression tests and is not a runtime dependency.

Installation

pip install --pre stepfork

The --pre flag is required while Stepfork is a pre-release. Requires Python 3.11, 3.12, or 3.13.

Installing from the GitHub tag remains available as an alternative:

pip install "git+https://github.com/utsab345/stepfork.git@v0.1.0a3"

What's included

  • Typed .sftrace trace bundles
  • Recording of agent executions
  • Tool and LLM boundary instrumentation
  • Local inspection and structural validation
  • Best-effort secret redaction
  • SHA-256 integrity verification
  • Frozen replay of instrumented tool/LLM boundaries
  • Behavioral diffing
  • Executable pytest regression-test export
  • A command-line interface (stepfork)

Known limitations

  • Alpha API and schema may change before v1.0.
  • Manual instrumentation is required; only instrumented boundaries are frozen.
  • No universal framework integration yet.
  • Frozen replay is not a sandbox and does not isolate arbitrary code.
  • Redaction is best-effort; do not rely on it for regulated data.
  • Not all agent behaviors can be deterministically replayed.
  • No automatic failure minimization.

Upgrade guidance

pip install --pre --upgrade stepfork

Versions are published under PEP 440 pre-release identifiers (0.1.0aN) and are immutable on PyPI; a broken release is yanked and replaced by a new version, not overwritten.

Feedback

https://github.com/utsab345/stepfork/issues

License

Apache License 2.0.