Software

One released compiler beta. One frozen 0.1 line.

v0.2.0b1 is the compiler lineage on main, released on 3 September 2026 and archived on Zenodo. The 0.1 beta stays tagged and reproducible for the results it archived.

Getting started

Install the current release.

python -m pip install "featuregraph @ git+https://github.com/featuregraph/featuregraph.git@v0.2.0b1"

The tag is the exact released source. It is not API-compatible with the 0.1 releases, and there is no migration path from the 0.1 object API: a 0.1 construction is re-expressed as a state contract. To reproduce a 0.1 result, install v0.1.0b1 instead, or work from the beta/v0.1.x branch.

Released API · v0.2.0b1

Contracts, compiled.

compile_states turns a declarative state contract into states, occurrences with identity, and boundary events, with exclusive and exhaustive validation and structured refusals. state-contract-v1 is frozen; v2 lets a contract carry its own derivations, so preprocessing sits inside the fingerprinted document. Study contracts are fingerprinted with SHA-256 and approved by a named person, and execution refuses anything unapproved. The release also ships the study intake and conversational builder behind the research assistant, shape measures over compiled occurrences, and the frozen study records.

Read the v0.2 README → Documentation →

0.1 line · v0.1.0b1

Oscillations, accumulations, and queries.

v0.1.0b1 constructs explicit oscillation objects and wave-derived accumulation objects, retains sample-level evidence, returns object tables, and supports deterministic object queries. It remains the authority for the results it archived and is maintained on beta/v0.1.x; nothing on main regenerates them.

Read the 0.1 beta API examples →

Research package

Reproduce a result from its release.

Each release has its own Zenodo version DOI, and the frozen study records on main name the release they ran under. Cite 10.5281/zenodo.22286856 for v0.2.0b1, 10.5281/zenodo.21984186 for the 0.1 beta, and 10.5281/zenodo.21939317 for all versions.