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

Uploaded Python 3Windows x86-64

ciris_verify-12.3.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.3.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.3.0-py3-none-macosx_11_0_arm64.whl (5.5 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

ciris_verify-12.3.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.3.0.tar.gz.

File metadata

  • Download URL: ciris_verify-12.3.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.3.0.tar.gz
Algorithm Hash digest
SHA256 1b5b8e9790d0e5130a5104c2dd302ca34b6f3eb13ab92a998c5a11c339e27fb8
MD5 da8c98a7fc9141bcebcf865fa361a969
BLAKE2b-256 77065a98e2bf7bca0de5a835b8762bb734a918f964248b8cef6b392160c4abaf

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.3.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 b7dca2ddef51fe30b3ddf55c73aa90c13df4f27492eca5822580ce207d02d4ef
MD5 feee7818763c2fabba78e9f596ac3336
BLAKE2b-256 a118395476d762503b93e98ca8abbf35016ae40416547dc5f7d772c41d9ec847

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7d50d0e3356dec80336271b06f4383a010055f9f87968806b1bd6318a4845e13
MD5 45960a8134fcd908884bbf902887a30c
BLAKE2b-256 8932f276cf034e9983caf65f744846a7ab78fc28acada471b763f4b7c9ae2cbb

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 26a8fdab837f69f805e50d03ade8da1bd69917a5715011c1e24921c5711a628e
MD5 67cdaf1d24b2b8950e6f443e4e3dbf07
BLAKE2b-256 ebda96bb1177ef6666cf7cbbd31a5a7769c68ebda230c84e0d0797c7670f9d94

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.3.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5e7a1d709b46db73d8df8a7ddf3fd89fae706d69fe4297dc039d6f6be2e23086
MD5 1db332886155f4ecc5f38418d4bd81e6
BLAKE2b-256 ac7b77874b1127cb09fdde545eab7a775894918d8c272f223f6c4a5d9832b27b

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for ciris_verify-12.3.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 164b45e9d4021d50da786db1a8d210e3e75b6587d2d9312fa6f6f21a2110e98d
MD5 39313b400ff70a64b738d000a950ef90
BLAKE2b-256 9e9eb3d01333afa25125ce5fbc372acdf0c71b275459a0261417945548c5df89

See more details on using hashes here.

Provenance

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

This release

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