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 Jul 2, 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 Jul 2, 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-8.4.0.tar.gz (79.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-8.4.0-py3-none-win_amd64.whl (6.6 MB view details)

Uploaded Python 3Windows x86-64

ciris_verify-8.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (6.5 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

ciris_verify-8.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.0 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

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

Uploaded Python 3macOS 11.0+ ARM64

ciris_verify-8.4.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-8.4.0.tar.gz.

File metadata

  • Download URL: ciris_verify-8.4.0.tar.gz
  • Upload date:
  • Size: 79.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ciris_verify-8.4.0.tar.gz
Algorithm Hash digest
SHA256 939cd812bb5f2bb67447647f9562845bb98b409dd8fcb3195076622411f0b883
MD5 9c728c1da359d77b69832fd3efcdbf4e
BLAKE2b-256 09b53bd27427616151906b75ec27e87584654e34b153156d502fda166e94ae90

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-8.4.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-8.4.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: ciris_verify-8.4.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 6.6 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ciris_verify-8.4.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 afec001ad147ab9bfa6eafa89bc9c5d10f71a10635215b27ce389cb566cb8ea6
MD5 95ede82ea2d7e78c0eb82a1defaf19e4
BLAKE2b-256 08b32874587d48837b9f3402217c53247fc42e04fb882718fb969c56116fd1bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-8.4.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-8.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ciris_verify-8.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 9e991637813879d9255910639e5c275b0ac373468cb77be10d9bd788e4453b46
MD5 15cdc2fa10d4041aeb26a5896a9f3d08
BLAKE2b-256 836b8988e1a3a84fad765963c2fdbf1792b6ac55d9711a0af4ece99d230700e4

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-8.4.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-8.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for ciris_verify-8.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 ecfa653dd6cb1ab6764b2d12619cdd96dbe9b15751c7f276beb43c9b8b3b12a7
MD5 fec54664e9ceaea8de49edf90cd1ccfd
BLAKE2b-256 a8eb4d5e44389d9d40daa2683feb2dcb220a1ba8ad37e2bf1e29156e24a7bec1

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-8.4.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-8.4.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ciris_verify-8.4.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1b75d9d8daa0f348c6de6b62d213bd0efcfad319d1514eb366ab314350b448df
MD5 82dabb006d8ee088b4d5503c5b857692
BLAKE2b-256 d50ef309a17d3a30e2ad57ae96597a756b75428ed7623cf584862c2e6fc978ed

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-8.4.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-8.4.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for ciris_verify-8.4.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 94c26359a80223994a757d7165d9ec043392a351e65d6d33479021f7af380cb8
MD5 69f7e819707b7f384dc4868bca2cdca0
BLAKE2b-256 6eed5dfbdb7c6a2ab67a16e8177d70e46cb2ab2ddc1325fed9a2ea859691fda6

See more details on using hashes here.

Provenance

The following attestation bundles were made for ciris_verify-8.4.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

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

This release

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