Quickstart (Python)

What it does

This example walks through the complete Grantex authorization lifecycle using the Python SDK:

Register an agent with calendar:read and email:send scopes
Authorize in sandbox mode — the sandbox API key auto-approves and returns a code immediately (no redirect required)
Exchange the code for a signed RS256 grant token
Verify the token offline against the local JWKS endpoint
Log an audit entry recording a calendar.read action
Revoke the token and confirm revocation via an online verify check

Prerequisites

Python 3.9+
Docker (Docker Desktop or Docker Engine with Compose)

Run

Start the local Grantex stack from the repository root:

docker compose up --build

In a separate terminal, run the example:

cd examples/quickstart-py
pip install -r requirements.txt
python main.py

Expected output

Agent registered: ag_01HXYZ... did:grantex:ag_01HXYZ...
Auth request: areq_01HXYZ...
Sandbox auto-approved, code: 01JXYZ...
Grant token received, grantId: grnt_01HXYZ...
Scopes: calendar:read, email:send
Token verified offline:
  principalId: test-user-001
  agentDid:    did:grantex:ag_01HXYZ...
  scopes:      calendar:read, email:send
Audit entry logged: alog_01HXYZ...
Token revoked.
Post-revocation verify: revoked

Done! Full authorization lifecycle complete.

Environment variables

Variable	Default	Description
`GRANTEX_URL`	`http://localhost:3001`	Base URL of the Grantex auth service
`GRANTEX_API_KEY`	`sandbox-api-key-local`	API key. Use a sandbox key for auto-approval

Source code

The full source is in examples/quickstart-py/main.py.

Last modified on July 14, 2026

Quickstart (TS)Next.js Starter

​What it does

​Prerequisites

​Run

​Expected output

​Environment variables

​Source code

What it does

Prerequisites

Run

Expected output

Environment variables

Source code