refactual-sdk 0.1.0

Official Refactual REST API client for Python.

refactual-sdk

Official Refactual REST API client for Python.

Status: preview — this package is not yet published on PyPI. The API shape below is stable; until the publish lands, call the REST API directly with requests / httpx.

# Once published:
pip install refactual-sdk

Quickstart

from refactual import Refactual

client = Refactual(api_key="rk_live_...")
reply  = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Explain async/await"}],
)
print(reply["content"])

OAuth 2.0 (client_credentials)

token = Refactual(api_key="rk_placeholder").oauth.token(
    client_id="rc_live_xxx",
    client_secret="rcs_live_xxx",
    scope=["chat:write", "chat:read"],
)
client = Refactual(access_token=token["access_token"])

Webhook verification

from refactual import verify_webhook
verify_webhook(raw_body, request.headers.get("Refactual-Signature"), secret)

See API.md for the full reference.