Skip to main content

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

Patent License Python

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

Contact Sales

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


HSP ProtocolThe only architecture that makes AI compliance defensible.

Patent PCT/US26/11908 | © 2024-2026 Jaqueline de Jesus

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hsp_protocol-0.2.0.tar.gz (22.2 kB view details)

Uploaded Source

Built Distribution

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

hsp_protocol-0.2.0-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

Details for the file hsp_protocol-0.2.0.tar.gz.

File metadata

  • Download URL: hsp_protocol-0.2.0.tar.gz
  • Upload date:
  • Size: 22.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for hsp_protocol-0.2.0.tar.gz
Algorithm Hash digest
SHA256 872c5fca0d9084c5ee508da7b5c44df36b26dd8b05c3810fb0d94b71d89569a7
MD5 a66f0ed35f6b3451c71eddd6196baabd
BLAKE2b-256 aad3d5228b38c044c14f17d716ada6686e05d3ea3a312de2f0ecd03ab62157b1

See more details on using hashes here.

File details

Details for the file hsp_protocol-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: hsp_protocol-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 29.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for hsp_protocol-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6c6ea3e0554d5247b09e14b4a07cdec67bf59f6d73dc53f2bec8377930e82680
MD5 77f9de1aaca2aa31dc571491545ca766
BLAKE2b-256 98052ad2149bf649f6511043718284d590b64de1492be511f5e982a4b5527c43

See more details on using hashes here.

Supported by

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