Skip to main content

CIRISVerify Python Bindings

Python bindings for CIRISVerify, the hardware-rooted license verification module for the CIRIS ecosystem.

Installation

pip install ciris-verify

Platform wheels bundle the CIRISVerify native library. On other platforms, build it from source (see the CIRISVerify repository).

Licensing: a licence is a cosigned licensure:{authority}:v1 row (CC 4.4.3.34). CIRISVerify does not yet evaluate licensure rows, so get_license_status reports UNLICENSED_COMMUNITY or a more restrictive status for every deployment, and status.license is None.

Quick Start

import os
from ciris_verify import CIRISVerify, LicenseStatus

# Initialize the verifier
verifier = CIRISVerify()

# Get license status with a fresh nonce
status = await verifier.get_license_status(
    challenge_nonce=os.urandom(32)
)

# Check if professional capabilities are available
if status.allows_licensed_operation():
    print("Professional license verified!")
    print(f"Tier: {status.license.tier}")
    print(f"Capabilities: {status.license.capabilities}")
else:
    print("Running in community mode")

# IMPORTANT: Always display the mandatory disclosure
print(status.mandatory_disclosure.text)

Mandatory Disclosure

Per the CIRIS ecosystem rules, agents MUST display the mandatory_disclosure.text to users. This ensures transparency about the agent's capabilities and licensing status.

# The disclosure MUST be shown to users
disclosure = status.mandatory_disclosure
print(f"[{disclosure.severity.upper()}] {disclosure.text}")

Capability Checking

For frequent capability checks, use the fast path:

result = await verifier.check_capability("medical:diagnosis")
if result.allowed:
    # Capability is available
    pass
else:
    print(f"Capability denied: {result.reason}")

Testing

For testing without the actual binary, use MockCIRISVerify:

from ciris_verify import MockCIRISVerify, LicenseStatus

# Create a mock that returns community mode
verifier = MockCIRISVerify(
    mock_status=LicenseStatus.UNLICENSED_COMMUNITY
)

# Use exactly like the real client
status = await verifier.get_license_status(os.urandom(32))
assert status.status == LicenseStatus.UNLICENSED_COMMUNITY

Error Handling

from ciris_verify import (
    CIRISVerifyError,
    BinaryNotFoundError,
    BinaryTamperedError,
    VerificationFailedError,
)

try:
    verifier = CIRISVerify()
    status = await verifier.get_license_status(os.urandom(32))
except BinaryNotFoundError as e:
    # Binary not installed
    print(f"CIRISVerify not found: {e.path}")
except BinaryTamperedError:
    # CRITICAL: Binary has been modified
    # Halt all operations immediately
    raise SystemExit("SECURITY ALERT: Binary integrity compromised")
except VerificationFailedError as e:
    # Verification failed - operate in restricted mode
    print(f"Verification failed: {e}")

License Status Codes

Status Code Description
LICENSED_PROFESSIONAL 100 Full professional license active
LICENSED_PROFESSIONAL_GRACE 101 License valid, in offline grace period
UNLICENSED_COMMUNITY 200 Community mode, no professional capabilities
RESTRICTED_* 300-399 Restricted mode due to verification issues
ERROR_* 400-499 Error states (revoked, expired, etc.)
LOCKDOWN_* 500+ Critical security failure, halt operations

Thread Safety

The client is thread-safe and can be used from multiple threads or async tasks concurrently.

License

AGPL-3.0-or-later - See LICENSE file in the CIRISVerify repository.

Metadata

Release files for ciris-verify 23.1.3

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

Source distribution (sdist)

Source distribution for ciris-verify 23.1.3
File Size Uploaded Provenance Actions
ciris_verify-23.1.3.tar.gz 92.6 kB With provenance Details for ciris_verify-23.1.3.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for ciris-verify 23.1.3
File Actions
ciris_verify-23.1.3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for ciris_verify-23.1.3-py3-none-win_amd64.whl
ciris_verify-23.1.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for ciris_verify-23.1.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
ciris_verify-23.1.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for ciris_verify-23.1.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
ciris_verify-23.1.3-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for ciris_verify-23.1.3-py3-none-macosx_11_0_arm64.whl
ciris_verify-23.1.3-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for ciris_verify-23.1.3-py3-none-macosx_10_12_x86_64.whl

Total release size: 29.2 MB

Release files / ciris_verify-23.1.3.tar.gz

Download URL ciris_verify-23.1.3.tar.gz
Size 92.6 kB
Tags Source
SHA-256 checksum
How to use checksums
7016d34fcfab8abe45653667d5da5cefa6023fc999dc0bdd5bc9baf7bc1842ce
BLAKE2b-256 checksum
How to use checksums
d80c143d224788f8dc2c190ecdee6235cae3ebee345b0326c27fb7de41f23788
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ciris_verify-23.1.3-py3-none-win_amd64.whl

Download URL ciris_verify-23.1.3-py3-none-win_amd64.whl
Size 6.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
4dce2b5586fc083b2f3e22f9745c5d8a4e20dbb35e720406fdee73f0329b6f5e
BLAKE2b-256 checksum
How to use checksums
717da21df10691f7cc83ad822308d296e479d151c581603da89c0d0b0ea916a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ciris_verify-23.1.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL ciris_verify-23.1.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 6.2 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
92b2f4a8c31c357f99eb5559085d43591e21248e5837fdfbe1086d8740e4e6ce
BLAKE2b-256 checksum
How to use checksums
1c1e25ecbe71fcbc0cab777b8dc5f3be6dcfe3070979955817d0921fd02d75e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ciris_verify-23.1.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL ciris_verify-23.1.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 5.7 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
67cfb0117d4f0144e310890dc16aed94d50b86e607252236649292b0d94bf546
BLAKE2b-256 checksum
How to use checksums
2a524f9c0cf1a0f5a675c038571e3431ca6caa28e1f32d3bab757a5908e8ca65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ciris_verify-23.1.3-py3-none-macosx_11_0_arm64.whl

Download URL ciris_verify-23.1.3-py3-none-macosx_11_0_arm64.whl
Size 5.2 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
c75676cd82687c14a3001ff8146e06a14ee3a0a30bdb890db01887ca5f8bdc03
BLAKE2b-256 checksum
How to use checksums
e8ef64d4a631628faba619936002cdc065dc16a6fd582c22695b42ab81ee5850
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ciris_verify-23.1.3-py3-none-macosx_10_12_x86_64.whl

Download URL ciris_verify-23.1.3-py3-none-macosx_10_12_x86_64.whl
Size 5.7 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
0a964103428770553a5c2e6af5f773ad2fa5d3ce5b20a27da6bde5a5d84d243a
BLAKE2b-256 checksum
How to use checksums
4377e245b4eac008063a88f2cabb40149eae86dc4dedd6ca770d1a6edfcbccd0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for ciris-verify 23.1.3

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.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for ciris_verify-23.1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

23.1.3 This release

6 release files Full 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