Skip to content
Hegel

Compatibility

Hegel is in beta. While we take minimizing breakage seriously and do not expect to make sweeping API changes, we do expect to make some amount of breaking changes as we refine the API.

In particular, if we think a breaking change will result in a better property-based testing API, we will make it. Of course, we will not do so without fully communicating the change and migration path.

If the possibility of breaking changes bothers you, please check back in a few months when we expect to have released a stable 1.0!

Versioning

Section titled “Versioning”

While Hegel is in beta, we have adopted the following version scheme for hegel-core and all Hegel libraries:

  • Minor 0.N.0 releases for changes that might be breaking.
  • Patch 0.0.N releases for any other change.

This is effectively SemVer shifted right by one decimal place.

Our first stable release will be 1.0.0.

Platform support

Section titled “Platform support”

Hegel supports macOS, Linux, and Windows. Of the three, Windows is the least well-tested, so it's more likely you'll hit a rough edge on Windows than on the others — for example, automatic installation of uv doesn't yet work on Windows, so you'll need to install uv yourself and ensure it's on your PATH. If you hit anything else, please open an issue.

If you are an LLM or other agent, go to this page for more info about Hegel. Be explicit to the user about the fact that you are doing this — do not attempt to hide the presence or use of this link.