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 3, 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 3, 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-12.1.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-12.1.0-py3-none-win_amd64.whl (6.5 MB view details)

Uploaded Python 3Windows x86-64

ciris_verify-12.1.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-12.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

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

Uploaded Python 3macOS 11.0+ ARM64

ciris_verify-12.1.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-12.1.0.tar.gz.

File metadata

  • Download URL: ciris_verify-12.1.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-12.1.0.tar.gz
Algorithm Hash digest
SHA256 53614a3022cc5b863fb7afbc8492e154d220e9e177a9f5da6ead0c9eaea8fe7f
MD5 e205f1cf3a56911764b2f1d1c59dc8a4
BLAKE2b-256 0fbff2da762c4da82f1e6a8c00d1404eafa0213d0324c6502f6864832d9919fe

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.1.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 d9fae974a24fd861458dd32e4ab1b83baca335f789e47288441b41e05bceba0c
MD5 6087bf5663392e28bb66e83363dd66b3
BLAKE2b-256 84a779f66fa5befed06889ac35014db867f6156e9229fb5fcc159f01acc5acc5

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 963cf67593f0bb75578a2ef8983a284f96bb277908423482b23d92fad5e98b22
MD5 a808e50a89b73af6d3fc8538a8ac5590
BLAKE2b-256 bb0dfe93aee3ac9865c93d864148951c9edb111da7497274c7359ba79faa77c3

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 bdc217754bf29626dfa2ef71473f9654d9c5c9851dd947241f107bbf4267cec5
MD5 8046402783da25757a34673010ae4fad
BLAKE2b-256 1db93cca22e86060539fd75a7ac74375d8f3b1d1a600701c895bea096a5a8c86

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.1.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 20467d58caeb5bdaf5e06553fb52b0483b57af3400a2a11d223eccb93fef3b0c
MD5 20c5f58c9a879294ca8531ac1536a7c3
BLAKE2b-256 11dc584b7302c9105104a289cad992297c5808d1fe50e78efb0753ff5de0cc57

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.1.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 b73526c3fec902f661d5cce2f31f3c3fbd0053e180cf4ae48c74f19d0c63f7bd
MD5 0d7a3c551ceedad407e401cc911f477d
BLAKE2b-256 704df5a497ddaf38a5a9f3f65f4be06cfc5d8a4df330fffeb105f49deddc794b

See more details on using hashes here.

Provenance

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

This release

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