---
id: ciris-verify
version: "13.2.0"
license: AGPL-3.0-or-later
license_treatment: agpl
maintenance: active
---

# ciris-verify — Python bindings for CIRISVerify hardware-rooted license verification

License: agpl · Maintenance: active · Downloads: 89.8K/mo

## What it is and what it does

CIRISVerify is a Python wrapper around a hardware-rooted license verification system designed for the CIRIS ecosystem. It lets you check whether a software installation has a valid professional license, what capabilities are available under that license, and whether the system is running in community (unlicensed) mode. The package depends on pydantic for data validation and requires the separate CIRISVerify binary to perform actual verification.

The typical workflow is to initialize a verifier, call get_license_status() with a challenge nonce, and inspect the returned status object to decide whether to enable licensed features or operate in restricted community mode. The package enforces mandatory disclosure: you must display the disclosure text to users to ensure transparency about the agent's capabilities and licensing state. It also provides a MockCIRISVerify class for testing without the binary, and detailed error types (BinaryNotFoundError, BinaryTamperedError, VerificationFailedError) to handle different failure modes.

Use it for:

- Gate professional AI agent capabilities behind license verification, falling back to community mode when unlicensed.
- Verify license tier and display appropriate feature sets to users based on their subscription level.
- Detect binary tampering or integrity violations and halt operations immediately as a security safeguard.
- Test license-dependent code paths in CI/CD pipelines using MockCIRISVerify without requiring the binary.
- Handle offline scenarios gracefully using the LICENSED_PROFESSIONAL_GRACE status during grace periods.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to verify hardware-rooted software licenses through the CIRISVerify binary, checking license status and capability permissions with mandatory disclosure enforcement.

Yes, with conditions. Install if you are building within the CIRIS ecosystem and need to enforce license-based capability gating with hardware-rooted verification. The package is actively maintained, has no known vulnerabilities, and provides clear error handling and testing support. However, the separate binary dependency and AGPL-3.0-or-later license mean you must verify binary availability before deployment and review copyleft obligations for your use case.

## Install

pip install ciris-verify
uv add ciris-verify
poetry add ciris-verify

## Installing ciris-verify

Before you install: Medium install friction: requires the separate CIRISVerify binary to be installed independently of the Python package. Active maintenance (released 2026-08-14, last commit 2026-08-14) with current Python support (3.10–3.13). Prebuilt wheels available for macOS, Linux, and Windows.

License in practice: AGPL-3.0-or-later: derivative works and modifications must be released under the same license. Suitable for open-source projects; proprietary or closed-source applications should review AGPL obligations carefully before adoption.

Quickstart:

pip install ciris-verify

import os
from ciris_verify import CIRISVerify

verifier = CIRISVerify()
status = await verifier.get_license_status(challenge_nonce=os.urandom(32))
if status.allows_licensed_operation():
    print(f"Tier: {status.license.tier}")
print(status.mandatory_disclosure.text)

The CIRISVerify binary must be installed separately; the Python package alone is not functional without it. Requires Python 3.10 or later.

Verify before relying:

- Whether the mandatory disclosure enforcement is a hard requirement or advisory in production deployments.
- Performance characteristics and latency of license verification calls in high-concurrency scenarios.
- Behavior and fallback strategy when the binary is unavailable or verification fails in production.

## Package facts

- License: AGPL-3.0-or-later (agpl)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 89.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

hardware license verification, license status checking, cryptographic license validation, ciris ecosystem integration, capability-based access control, license tier verification, offline grace period handling, license-verification, hardware-rooted, capability-gating

[View on SkillFed](https://skillfed.io/packages/ciris-verify) · [View on PyPI](https://pypi.org/project/ciris-verify/)