Skip to main content

Human checkpoint infrastructure for AI workflows

Project description

HumanAgent Python SDK

Human checkpoint infrastructure for AI workflows. When your AI agent needs judgment, trust, or a licensed signature — HumanAgent routes it.

Install

pip install humanagent

Quick start

from humanagent import HumanAgent

client = HumanAgent(api_key="ha_live_...")

# Create a checkpoint and wait for result
result = client.checkpoint(
    task="Review NDA for compliance gaps",
    credential="bar_licensed:US",
    sla="30min",
    budget=25.00
)

if result["status"] == "completed":
    print(result["result"]["approved"])   # True/False
    print(result["result"]["notes"])      # Reviewer's notes
    print(result["audit_hash"])           # SHA-256 tamper-evident hash

# Fire and forget (use webhook)
created = client.checkpoint(
    task="Pick best 3 ad creatives",
    credential="general",
    sla="1hr",
    budget=5.00,
    callback_url="https://my-agent.com/webhook",
    wait=False
)
print(created["checkpoint_id"])

API

HumanAgent(api_key, base_url=None, timeout=30)

Initialize the client.

.checkpoint(task, credential, sla, budget, ...wait=True)

Create a checkpoint. If wait=True, polls until result. If wait=False, returns immediately.

.create_checkpoint(task, credential, sla, budget, ...)

Create without waiting.

.get_checkpoint(checkpoint_id)

Poll status.

More info

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

humanagent-0.1.0.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

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

humanagent-0.1.0-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file humanagent-0.1.0.tar.gz.

File metadata

  • Download URL: humanagent-0.1.0.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.1

File hashes

Hashes for humanagent-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b8b8947c03c6636bf20139a90692ef16c740084113ad811c8d87320e4e9d9e6b
MD5 d4c0f4a87e49e5eba77da00f38553812
BLAKE2b-256 b8abf25bea7d1b7e01bb415abff9a35685552e1f876611b5ff70bdbfa732211b

See more details on using hashes here.

File details

Details for the file humanagent-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: humanagent-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.1

File hashes

Hashes for humanagent-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1a2873f8ca45208e47b507ff56cea646a64f88c1cd009051d6fcc06b31bdf289
MD5 223d41ef4ac47d111d16d881ec0ce39d
BLAKE2b-256 b98579364590b8a7f4db91cb58d5890ec079bc80dbedcb7f884163291cb6dd71

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