Python

Python 3.8+. Depends on requests and cryptography.

Install

pip install https://geckoguard.net/downloads/sdk/v1.3.0/geckoguard-1.3.0-py3-none-any.whl

This pins the reviewed historical v1.3.0 preview wheel. The first official coordinated release is planned as v1.0.0 and remains on hold.

Quick start

from geckoguard import GeckoGuardClient, LicenseDeniedError

client = GeckoGuardClient("gg_live_...", "your-product-uuid", signing_secret="your-signing-secret")

try:
    auth = client.authorize("LICENSE-KEY-123")
    print("Allowed:", auth["allow"])
except LicenseDeniedError as e:
    print("Denied:", e.response["reasonCode"])
    raise SystemExit(1)

Configuration

GeckoGuardClient(
    api_key="gg_live_...",
    product_id="your-product-uuid",
    base_url="https://api.geckoguard.net",
    signing_secret="your-signing-secret",  # required by the hosted API
    timeout=15,
)

For the full method list and endpoint reference, see the API Reference.

For long-running applications, follow the session lifecycle and heartbeat requirements.