v0.0.1

Initial release of the official Python SDK for HumanTone.

Features

• Three endpoints: humanize, detect, account.get
• Sync client (HumanTone) using requests
• Async client (AsyncHumanTone) via httpx, opt-in via pip install "humantone-sdk[async]"
• Full exception hierarchy with error_code, request_id, details, retryable accessors
• Configurable retry policy (POST does not retry on 5xx/network by default to avoid double-billing on humanize; opt-in via retry_on_post=True)
• HUMANTONE_API_KEY and HUMANTONE_BASE_URL env var support
• Retry-After header parsed in both numeric seconds and HTTP-date formats
• Frozen dataclass result types with full type hints
• PEP 561 compliant (py.typed marker)

Install

pip install humantone-sdk

For async:

pip install "humantone-sdk[async]"

Compatibility

Python 3.10, 3.11, 3.12, 3.13. Linux, macOS, Windows.