Human Supervision Protocol - Fail-closed AI governance for EU AI Act compliance
Project description
HSP Protocol SDK
Fail-Closed AI Supervision for EU AI Act Compliance
Overview
HSP Protocol provides the only patented fail-closed architecture for AI agent supervision that ensures EU AI Act Article 14 compliance.
Unlike probabilistic safety filters (RLHF, guardrails) that fail open, HSP implements cryptographic pre-execution approval that fails closed — no approval, no execution.
Supported Providers
| Provider | Package | Status |
|---|---|---|
| Google Gemini | hsp-protocol[gemini] |
✅ Production |
| OpenAI GPT | hsp-protocol[openai] |
✅ Production |
| Azure OpenAI | hsp-protocol[openai] |
✅ Production |
| Anthropic Claude | hsp-protocol[anthropic] |
✅ Production |
| AWS Bedrock | hsp-protocol[bedrock] |
✅ Production |
Installation
# Core (minimal)
pip install hsp-protocol
# With specific provider
pip install hsp-protocol[gemini]
pip install hsp-protocol[openai]
pip install hsp-protocol[anthropic]
pip install hsp-protocol[bedrock]
# All providers
pip install hsp-protocol[all]
Quick Start
from hsp_sdk import HSPClient
# Initialize with any provider
client = HSPClient(
provider="gemini", # or "openai", "azure", "anthropic", "bedrock"
organization="Acme Corp",
ai_system="CustomerBot",
risk_level="high" # EU AI Act classification
)
# All interactions are now supervised
response = client.chat("Process refund for order #12345")
# Generate compliance report (RAT)
rat = client.generate_rat(anchor_blockchain=True)
print(f"Report: {rat['report_url']}")
How It Works
┌─────────────────────────────────────────────────────────┐
│ YOUR AI AGENT │
│ │ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ HSP INTERCEPTOR │ ◄── Patented │
│ │ (Fail-Closed) │ │
│ └─────────────────────┘ │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ ▼ ▼ ▼ │
│ [Risk Score] [Human Approval] [Crypto Sign] │
│ │ │ │ │
│ └───────────────┼───────────────┘ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ IMMUTABLE LEDGER │ ◄── Polygon │
│ │ (Proof of Superv.) │ │
│ └─────────────────────┘ │
│ │ │
│ ▼ │
│ [EXECUTE / BLOCK] │
└─────────────────────────────────────────────────────────┘
Risk-Based Approval
| Risk Score | Action | Quorum |
|---|---|---|
| 0-40 | Auto-approve + log | 0 |
| 41-70 | Single human approval | 1 |
| 71-90 | Multi-sig approval | 2 |
| 91-100 | Critical review | 3+ |
Provider-Specific Usage
Google Gemini / Vertex AI
from hsp_sdk import HSPClient
client = HSPClient(
provider="gemini",
organization="HealthPlus",
ai_system="MedicalDiagnosis",
api_key="your-gemini-key" # or GOOGLE_API_KEY env var
)
OpenAI
client = HSPClient(
provider="openai",
organization="TradingCo",
ai_system="AlphaTrader"
# Uses OPENAI_API_KEY env var
)
Azure OpenAI
client = HSPClient(
provider="azure",
organization="Enterprise",
ai_system="CopilotCustom",
azure_endpoint="https://myresource.openai.azure.com/",
deployment="gpt-4o"
)
Anthropic Claude
client = HSPClient(
provider="anthropic",
organization="LegalFirm",
ai_system="ContractReview"
)
AWS Bedrock
client = HSPClient(
provider="bedrock",
organization="FinanceOrg",
ai_system="FraudDetector",
region="us-east-1"
)
Compliance Reports (RAT)
Generate a Report of Action & Traceability:
rat = client.generate_rat(
anchor_blockchain=True, # Polygon anchoring
sign_ecdsa=True # Cryptographic signature
)
print(rat)
# {
# "rat_id": "rat_hsp_abc123",
# "actions": [...],
# "approvals": [...],
# "blockchain": {
# "network": "polygon",
# "contract": "0x1BCe4baE...",
# "tx_hash": "0x..."
# },
# "compliance": {
# "eu_ai_act_art_14": "COMPLIANT",
# "iso_42001": "COMPLIANT"
# }
# }
EU AI Act Compliance
HSP Protocol directly implements:
- Article 14: Human oversight with pre-execution approval
- Article 29: Transparency via immutable audit logs
- Article 9: Risk management through dynamic risk scoring
- Annex IV: Technical documentation via RAT reports
Pricing
| Tier | Transactions/Month | Price |
|---|---|---|
| Starter | 10,000 | €499/mo |
| Business | 100,000 | €2,499/mo |
| Enterprise | Unlimited | €9,999/mo |
Patent Information
HSP Protocol is protected by international patent:
- PCT/US26/11908 (Priority Date: 2024)
- USPTO Pending: 63/948,692
- National phase entries: EP, CN, JP (2026-2027)
Commercial use requires licensing. Learn more
Support
- Documentation: https://docs.hsp-protocol.com
- Email: support@hsp-protocol.com
- Enterprise: enterprise@hsp-protocol.com
HSP Protocol — The only architecture that makes AI compliance defensible.
Patent PCT/US26/11908 | © 2024-2026 Jaqueline de Jesus
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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 hsp_protocol-0.1.0.tar.gz.
File metadata
- Download URL: hsp_protocol-0.1.0.tar.gz
- Upload date:
- Size: 18.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa55a6aed9cb8484596facb4d106d700b9229b2bcb837bfc7bea8aa44c9a0a12
|
|
| MD5 |
c73e6e7742105a73d0803a7ad7f2f793
|
|
| BLAKE2b-256 |
563241d5b2207f31c7e6c99631196cc656a005586cc3dced97c33bcabea82bd6
|
File details
Details for the file hsp_protocol-0.1.0-py3-none-any.whl.
File metadata
- Download URL: hsp_protocol-0.1.0-py3-none-any.whl
- Upload date:
- Size: 25.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d9e45af1dc33422751e3385be3382d65139197bfcfe8f152bd44f0cd8a45b596
|
|
| MD5 |
1384449c00951dedcd7bfa296a6c3e5e
|
|
| BLAKE2b-256 |
b5ba49ccda02468aeaaee9c4d6a78ceda55a10c48980ad8d7f1caddb03f020df
|