Back to Guardra

Developer docs — built like you'd want them.

Copy-pasteable code. No sign-up walls. Searchable. Versioned per release. If you can't figure something out in 5 minutes, open an issue on GitHub.

Hello world

from guardra import Guardra

g = Guardra(api_key="grd_...")

audit = g.audit(
    agent="support-bot",
    messages=[{"role": "user", "content": user_msg}],
)

if audit.critical:
    raise g.BlockedByPolicy(audit.reason)

print(audit.findings)   # List[Finding]
print(audit.score)      # 0-100, higher = safer
print(audit.fix_pr)     # URL to auto-generated PR

Quickstart

Install the SDK, make your first audit call, read findings — 5 minutes.

SDK reference

Full API surface for Python and Node. Type-safe. Async-first.

REST & GraphQL

Language-agnostic HTTP surface. Signed webhooks. OpenAPI spec.

CLI

Single binary. Works in CI. Ships fixes as PRs. Airgap-friendly.

Integrations

Drop-in for every tool your stack already runs.

Concepts

The model behind Guardra: detectors, policy-as-code, evaluation, enclaves.

Prefer to read code?

Everything's open-source on GitHub.

github.com/guardra →