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.

Project links

Data verified by PyPI on Aug 14, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (13.6.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for emoore from gravatar.com emoore

Credits

Author: CIRIS Engineering

GitHub Statistics

Data verified by PyPI on Aug 14, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

AGPL-3.0-or-later
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Classifiers

Report project as malware

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.2.0.tar.gz (83.2 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

ciris_verify-13.2.0-py3-none-win_amd64.whl (6.5 MB view details)

Uploaded Python 3Windows x86-64

ciris_verify-13.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (6.6 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

ciris_verify-13.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

ciris_verify-13.2.0-py3-none-macosx_11_0_arm64.whl (5.5 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

ciris_verify-13.2.0-py3-none-macosx_10_12_x86_64.whl (6.0 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file ciris_verify-13.2.0.tar.gz.

File metadata

  • Download URL: ciris_verify-13.2.0.tar.gz
  • Upload date:
  • Size: 83.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ciris_verify-13.2.0.tar.gz
Algorithm Hash digest
SHA256 c790a983b098efddd91e03944c36b97daf7c34d97150aff22ba034bbe0562a99
MD5 3a40b590118f58a456c7283a3b01ed31
BLAKE2b-256 70ee9bd4713e553984b38e29be07a07ea0b116a38aa43aff90b29e09a7345daa

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-13.2.0.tar.gz:

Publisher: release.yml on CIRISAI/CIRISVerify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_verify-13.2.0-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for ciris_verify-13.2.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 b2638eb882fa89abd72cd368302b3ced70a542ffb57622609f1f1c41c9a97777
MD5 953390b07764e86bc5b254b6db1f09cd
BLAKE2b-256 fe9ee9824bec5b42f6ccf2e12d4b58b504e6cb11fe6e4679b8aa1996da5403bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-13.2.0-py3-none-win_amd64.whl:

Publisher: release.yml on CIRISAI/CIRISVerify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_verify-13.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ciris_verify-13.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e37dcffbe7dc9b4cd0f432ad8fb870af36678c310bd40b0721754d709140d94a
MD5 6c76b7dfcc386d930714dd27e5be5067
BLAKE2b-256 2f9180e67f4d44b256f1c4e452c05c2dd8a6542c7470862e61eef85f3b4bd449

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-13.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on CIRISAI/CIRISVerify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_verify-13.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for ciris_verify-13.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 af63a0316324d1a74a71424138d00552d671abd7e7db2fd9bdafc2f204a671ae
MD5 7f5bd8fe3f1ea4a2013f90f86bad98ad
BLAKE2b-256 518cc1fe9fda398d7d3ba520e2659f8032a7a74b40c414fdd129dfc8a263c787

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-13.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on CIRISAI/CIRISVerify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_verify-13.2.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ciris_verify-13.2.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 40197c8d95962a81cbe3c8fc8ddfc7140d9edae1777d822e758857bb19b71f0b
MD5 680e6a6e699b4c166ee2b1438394d78a
BLAKE2b-256 1c46db374f94b87b077ca94c3d7493717f4aa7c6e57eca06887e1e1829cd76cb

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-13.2.0-py3-none-macosx_11_0_arm64.whl:

Publisher: release.yml on CIRISAI/CIRISVerify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ciris_verify-13.2.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for ciris_verify-13.2.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 ad0b105714f2b60924ed8553960378ce028f1bcb528fb9ad1aa1313885a0b414
MD5 eab7682c2dd8d88aff141fa686aaba62
BLAKE2b-256 e60febfb01c6908de3d917b830a4d6142350767b830c603eff153531861749ea

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-13.2.0-py3-none-macosx_10_12_x86_64.whl:

Publisher: release.yml on CIRISAI/CIRISVerify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

13.6.1

13.6.0

13.5.0

13.4.0

13.3.1

13.3.0

This release

13.2.0

13.1.0

13.0.0

12.6.0

12.5.0

12.4.0

12.3.0

12.2.0

12.1.0

12.0.0

11.1.0

11.0.0

10.11.0

10.10.0

10.9.0

10.8.0

10.7.0

10.6.3

10.6.2

10.6.1

10.6.0

10.5.1

10.5.0

10.4.0

10.3.0

10.2.0

10.1.1

10.1.0

10.0.0

9.0.2

9.0.1

9.0.0

8.12.0

8.10.1

8.10.0

8.9.0

8.8.0

8.7.0

8.6.0

8.5.0

8.4.0

8.3.0

8.2.0

8.1.0

8.0.0

7.6.0

7.5.1

7.5.0

7.4.0

7.3.0

7.2.0

7.1.0

7.0.0

6.12.0

6.11.0

6.10.0

6.9.0

6.8.1

6.8.0

6.7.1

6.7.0

6.6.1

6.6.0

6.5.0

6.4.1

6.4.0

6.3.0

6.2.0

6.1.1

6.1.0

6.0.0

5.14.0

5.13.0

5.12.0

5.11.0

5.10.0

5.9.0

5.8.0

5.7.1

5.7.0

5.6.0

5.5.0

5.4.0

5.3.1

5.3.0

5.2.0

5.1.3

5.1.0

5.0.0

4.11.0

4.10.0

4.9.0

4.8.1

4.8.0

4.7.1

4.7.0

4.6.0

4.5.0

4.4.3

4.4.2

4.2.0

4.1.0

4.0.0

3.9.0

3.8.0

3.7.0

3.6.0

3.4.0

3.3.0

3.2.0

3.1.0

3.0.1

3.0.0

2.14.0

2.13.0

2.12.0

2.11.0

2.10.0

2.9.0

2.8.0

2.7.0

2.6.1

2.6.0

2.5.0

2.4.0

2.3.0

2.2.0

2.1.5

2.1.3

2.1.2

2.1.1

2.1.0

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

1.14.0

1.13.3

1.13.2

1.13.1

1.13.0

1.12.2

1.12.1

1.12.0

1.11.3

1.11.1

1.11.0

1.10.2

1.10.1

1.10.0

1.9.0

1.8.6

1.8.5

1.8.4

1.8.3

1.8.1

1.8.0

1.7.0

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.11

1.5.10

1.5.9

1.5.8

1.5.6

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0

1.3.9

1.3.8

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.1

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.27

1.1.26

1.1.25

1.1.24

1.1.23

1.1.22

1.1.21

1.1.20

1.1.19

1.1.18

1.1.17

1.1.16

1.1.15

1.1.14

1.1.13

1.1.12

1.1.11

1.1.10

1.1.9

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.1

1.0.0

0.10.19

0.10.18

0.10.17

0.10.16

0.10.15

0.10.14

0.10.13

0.10.12

0.10.10

0.10.9

0.10.8

0.10.7

0.10.6

0.10.5

0.10.4

0.10.3

0.10.2

0.10.1

0.10.0

0.9.8

0.9.7

0.9.6

0.9.5

0.9.4

0.9.3

0.9.2

0.9.1

0.9.0

0.8.19

0.8.18

0.8.17

0.8.16

0.8.15

0.8.14

0.8.13

0.8.12

0.8.11

0.8.10

0.8.9

0.8.8

0.8.7

0.8.6

0.8.5

0.8.4

0.8.3

0.8.2

0.8.1

0.8.0

0.7.13

0.7.12

0.7.11

0.7.10

0.7.9

0.7.8

0.7.7

0.7.6

0.7.5

0.7.4

0.7.3

0.7.2

0.7.1

0.7.0

0.6.17

0.6.16

0.6.15

0.6.14

0.6.13

0.6.12

0.6.11

0.6.10

0.6.9

0.6.8

0.6.7

0.6.6

0.6.5

0.6.4

0.6.3

0.6.2

0.6.1

0.5.4

0.5.3

0.5.0

0.3.8

0.3.7

0.3.6

0.3.5

0.3.0

0.2.1

0.1.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page