CIRISVerify Python Bindings
Python bindings for CIRISVerify, the hardware-rooted license verification module for the CIRIS ecosystem.
Installation
pip install ciris-verify
Note: The CIRISVerify binary must be installed separately. See the CIRISVerify documentation for installation instructions.
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ciris_verify-13.3.1.tar.gz
(83.3 kB
view details)
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ciris_verify-13.3.1.tar.gz.
File metadata
- Download URL: ciris_verify-13.3.1.tar.gz
- Upload date:
- Size: 83.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
52a2663d9e3d3e5fdde08ab9e85d99cee804725e81b5d4baedcc5fb47754a82c
|
|
| MD5 |
5eb82bc9a9e11d5fe4484e4b3c091e34
|
|
| BLAKE2b-256 |
64ea07bbc052d93c5dff2eeda53de3fd0e4c531e1073b0b7baa92f72074b17bf
|
Provenance
The following attestation bundles were made for ciris_verify-13.3.1.tar.gz:
Publisher:
release.yml on CIRISAI/CIRISVerify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_verify-13.3.1.tar.gz -
Subject digest:
52a2663d9e3d3e5fdde08ab9e85d99cee804725e81b5d4baedcc5fb47754a82c - Sigstore transparency entry: 2476764782
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISVerify@82960ea7eb49db1a14535501042179e17635beed -
Branch / Tag:
refs/tags/v13.3.1 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@82960ea7eb49db1a14535501042179e17635beed -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_verify-13.3.1-py3-none-win_amd64.whl.
File metadata
- Download URL: ciris_verify-13.3.1-py3-none-win_amd64.whl
- Upload date:
- Size: 6.5 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d20ad53d78fde631a52f1678366ebf3a61f8795f10162eba29dafb7c8a93a581
|
|
| MD5 |
daf7e0e9c7a371b422f1eb403f5867d5
|
|
| BLAKE2b-256 |
00591f382a381c9cd9c52d43903a2ed3e39e38aee9c175cca3a40af285d07f04
|
Provenance
The following attestation bundles were made for ciris_verify-13.3.1-py3-none-win_amd64.whl:
Publisher:
release.yml on CIRISAI/CIRISVerify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_verify-13.3.1-py3-none-win_amd64.whl -
Subject digest:
d20ad53d78fde631a52f1678366ebf3a61f8795f10162eba29dafb7c8a93a581 - Sigstore transparency entry: 2476764997
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISVerify@82960ea7eb49db1a14535501042179e17635beed -
Branch / Tag:
refs/tags/v13.3.1 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@82960ea7eb49db1a14535501042179e17635beed -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_verify-13.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: ciris_verify-13.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 6.6 MB
- Tags: Python 3, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a6f33043fe383d641dc2c671bafb2610b079d54e52d4abf7b013f9c8c7ac8124
|
|
| MD5 |
934d18e15a3def3a956c870824dfa1a5
|
|
| BLAKE2b-256 |
29571232025257ea9d339efaee1078b889f66f68b944d0036ddbc22b289a28c7
|
Provenance
The following attestation bundles were made for ciris_verify-13.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:
Publisher:
release.yml on CIRISAI/CIRISVerify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_verify-13.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl -
Subject digest:
a6f33043fe383d641dc2c671bafb2610b079d54e52d4abf7b013f9c8c7ac8124 - Sigstore transparency entry: 2476765425
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISVerify@82960ea7eb49db1a14535501042179e17635beed -
Branch / Tag:
refs/tags/v13.3.1 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@82960ea7eb49db1a14535501042179e17635beed -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_verify-13.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: ciris_verify-13.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 6.1 MB
- Tags: Python 3, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e692e3cefda81fb0f9162d294e1f56dd6d4c0cbd3f40b9e32c5455c8b4099549
|
|
| MD5 |
cddfa344501b22fd152d3a8b774551ee
|
|
| BLAKE2b-256 |
1ec8e70349ed36e6ad334df3aaeb8c8ed5772b9e25128caf48f402714f9e35e1
|
Provenance
The following attestation bundles were made for ciris_verify-13.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:
Publisher:
release.yml on CIRISAI/CIRISVerify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_verify-13.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl -
Subject digest:
e692e3cefda81fb0f9162d294e1f56dd6d4c0cbd3f40b9e32c5455c8b4099549 - Sigstore transparency entry: 2476765253
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISVerify@82960ea7eb49db1a14535501042179e17635beed -
Branch / Tag:
refs/tags/v13.3.1 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@82960ea7eb49db1a14535501042179e17635beed -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_verify-13.3.1-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: ciris_verify-13.3.1-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 5.5 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6094cf261476a13bd347176e7a75664c66a6ca48cbd8afed8812271e23a8af30
|
|
| MD5 |
de37c9ee4fbcebca03d224609a86b0ee
|
|
| BLAKE2b-256 |
815af6c1a52b674ae7b41cf0f00ed892354efd037d9d74124b5af927abb701e7
|
Provenance
The following attestation bundles were made for ciris_verify-13.3.1-py3-none-macosx_11_0_arm64.whl:
Publisher:
release.yml on CIRISAI/CIRISVerify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_verify-13.3.1-py3-none-macosx_11_0_arm64.whl -
Subject digest:
6094cf261476a13bd347176e7a75664c66a6ca48cbd8afed8812271e23a8af30 - Sigstore transparency entry: 2476765523
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISVerify@82960ea7eb49db1a14535501042179e17635beed -
Branch / Tag:
refs/tags/v13.3.1 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@82960ea7eb49db1a14535501042179e17635beed -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_verify-13.3.1-py3-none-macosx_10_12_x86_64.whl.
File metadata
- Download URL: ciris_verify-13.3.1-py3-none-macosx_10_12_x86_64.whl
- Upload date:
- Size: 6.0 MB
- Tags: Python 3, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1233fbacec44ac876564783ca69f30c370a5a5d5f1323e3c53ef9a2e5c6d3757
|
|
| MD5 |
2bee35a2dc4cf8e1768625cc65173906
|
|
| BLAKE2b-256 |
f3b6de0f3ce21c3d5c97332d0b53410da6de9069cec1806bf0ba25bc0e34297f
|
Provenance
The following attestation bundles were made for ciris_verify-13.3.1-py3-none-macosx_10_12_x86_64.whl:
Publisher:
release.yml on CIRISAI/CIRISVerify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_verify-13.3.1-py3-none-macosx_10_12_x86_64.whl -
Subject digest:
1233fbacec44ac876564783ca69f30c370a5a5d5f1323e3c53ef9a2e5c6d3757 - Sigstore transparency entry: 2476765122
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISVerify@82960ea7eb49db1a14535501042179e17635beed -
Branch / Tag:
refs/tags/v13.3.1 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@82960ea7eb49db1a14535501042179e17635beed -
Trigger Event:
push
-
Statement type:
