atomlabs

Pre-execution AI governance for every model you use.

Install

# From a local checkout (editable)
pip install -e /path/to/lcac/sdk

# Or directly from git
pip install git+https://github.com/atomlabs/atom-sdk-python.git

Requires Python 3.8+ and requests>=2.28.0.

Quick Start

from atomlabs import ATOMClient, GovernanceBlockError

client = ATOMClient(
    api_key="lcac_your_key_here",
    tenant_id="your-tenant-id"
)

# Make a governed call
result = client.governed_call(
    "Analyze this customer complaint...",
    provider="groq"
)

if client.is_allowed(result):
    print(client.get_output(result))
    print(f"RIS Level: {client.get_ris_level(result)}")
    print(f"CII Score: {client.get_cii_score(result)}")

# Raise exception if blocked
try:
    output = client.governed_call_or_raise(
        "Your prompt here",
        provider="anthropic"
    )
except GovernanceBlockError as e:
    print(f"Blocked: {e.reason}")
    print(f"RIS: {e.ris_level}, CII: {e.cii}")

Methods

Team Management

User management (invites, roles, listing) is handled via the console UI at https://console.atomlabs.app or the HTTP API under /api/tenants/{tenant_id}/users. Native SDK methods for team management will ship in a future release.

Roles available via the API: admin · developer · viewer · security_officer

Webhooks

Webhook management (create, list, delete) is available via the HTTP API at /api/tenants/{tenant_id}/webhooks and the console UI. Native Python SDK methods will ship in a future release.

Payloads are signed with HMAC-SHA256. Verify the X-ATOM-Signature header.

Local Models

# Use a local GGUF model (zero data egress)
result = client.governed_call(
    "Your prompt",
    provider="local",
    model="llama-3.2-3b-instruct.Q4_K_M.gguf"
)

Local models run on your infrastructure. No data leaves your environment.

Providers

groq · anthropic · gemini · mistral · openai · local

CLI

# Health check
python -m atomlabs health --api-key lcac_... --tenant-id your-tenant

# Make a governed call
python -m atomlabs call --input "Your prompt" --provider groq \
  --api-key lcac_... --tenant-id your-tenant

# Or via environment variables
export ATOM_API_KEY=lcac_...
export ATOM_TENANT_ID=your-tenant
python -m atomlabs health
python -m atomlabs call --input "Your prompt"
python -m atomlabs traces --limit 10
python -m atomlabs agents

Documentation

https://console.atomlabs.app/docs