Skip to main content

StageSAT

A floating-point constraint solver via staged optimization. MIT licensed.

Install

Release targets: CPython 3.11–3.13 on Linux x86-64 (glibc) and macOS Apple Silicon. See PACKAGING.md for validation status and release checks.

# From the repository root:
python -m pip install ./pypi

Solving requires Clang and the running Python's development headers, including when installed from a wheel. On macOS install Xcode Command Line Tools with xcode-select --install. On Linux install Clang and the development package matching your Python version (for example, python3.11-dev). Conda Python installations normally include their headers.

Solve

stagesat input.smt2 --bench --time
# Equivalent module invocation:
python -m stagesat input.smt2 --bench --time

The command generates and compiles the objectives automatically in a private temporary directory, passes their paths to spawned optimizer processes, and removes temporary files on completion. It works outside the source checkout and allows concurrent invocations from the same directory.

--bench suppresses debug output. Standard output contains the sat/unsat verdict followed by solver wall time in seconds when --time is present. Compilation and verification time are excluded from this solver timing, as in the original workflow. Diagnostics go to standard error.

stagesat input.smt2 --bench --time --jobs 4
stagesat --help
stagesat --version

--jobs defaults to the CPU count. Select a particular compiler with --clang /path/to/clang or STAGESAT_CLANG. Compilation errors exit with status 2 and an explanation; interruption exits with status 130.

The original optimizer, thresholds, and verdict rule are preserved: a zero best residual reports sat; otherwise the solver reports unsat. The original verification checks produce diagnostics without changing that verdict.

Develop and release

This directory is the complete Python packaging project. The original repository's source files are unchanged. Package metadata is in pyproject.toml, and the single version source is src/stagesat/_version.py.

cd pypi
python -m pip install build twine
python tools/check_release.py --dependencies minimum
python tools/check_release.py --dependencies latest

These commands build distributions and test wheel and source installations in fresh environments outside the checkout. See PACKAGING.md for the dependency audit, native platform CI, and PyPI publishing instructions.

Metadata

Release files for stagesat 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for stagesat 0.1.0
File Size Uploaded Provenance Actions
stagesat-0.1.0.tar.gz 40.2 kB Without provenance Details for stagesat-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for stagesat 0.1.0
File Interpreter ABI Platform Actions
stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64 Details for stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Total release size: 148.8 kB

Release files / stagesat-0.1.0.tar.gz

Download URL stagesat-0.1.0.tar.gz
Size 40.2 kB
Tags Source
SHA-256 checksum
How to use checksums
76bd8ed6070256d5b8815c01eefb9a522a0164427b7c14ffa1ca291e7efc3b98
BLAKE2b-256 checksum
How to use checksums
bb0f98726f9e6e228c784445d7c55133d48881f4207e8aa13e6567f060c8e78f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Release files / stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 108.6 kB
Tags CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
2e09b12ba3e72098369e24a9bea5331a3571d72d71491f8f0065c339c3f462ad
BLAKE2b-256 checksum
How to use checksums
43bf63b3af798630ba050a79019671005d0fc208c0171cfa9f51c086fdeafe29
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Security for stagesat 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page