Metadata-Version: 2.4
Name: acretix-verify-sdk
Version: 0.1.0
Summary: Python client for the AI Verify API - rubric-based verdicts with signed, re-verifiable proofs.
License: MIT
Project-URL: Documentation, https://api.acretix.io/docs
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# acretix-verify-sdk

Python client for the [AI Verify API](https://api.acretix.io/docs) — submit work against a rubric
and receive a scored, explained verdict with an Ed25519-signed, independently re-verifiable proof.

```python
import os
from acretix_verify import AcretixVerify

client = AcretixVerify(api_key=os.environ["VERIFY_API_KEY"])

rubric = client.compile_rubric({
    "name": "invoice-check",
    "criteria": [
        {"key": "total_present", "type": "must_have", "primitive": "regex_match@1",
         "config": {"pattern": r"Total: \$[0-9]+"}},
    ],
})

verdict = client.submit_verification(
    rubric_id=rubric["rubric_id"],
    submission={"inline": "Invoice... Total: $420"},
    wait_ms=30000,
    idempotency_key="invoice-001",
)
# verdict["determination"]: "met" | "partial" | "not_met" — flagged=True means needs_review:
# below the confidence threshold the engine abstains rather than asserting a verdict.

report = client.reverify(verdict["verification_id"])
# report["ok"] and report["chain_ok"] — the proof verifies against the published public key.
```

- Verdicts below the confidence threshold are **flagged `needs_review`** — the engine abstains
  instead of guessing; your application decides what happens next.
- Proofs are signed with Ed25519 and re-verifiable by any third party against the published
  public key — see the [docs](https://api.acretix.io/docs) for the proof format.
- Also available: `get_verification`, `wait_for_verification`, `get_proof`, `get_usage`, `submit_feedback`.
- Usage is metered per verification by judge tier.

Standard library only (urllib). Python 3.9+.

License: MIT
