Skip to main content

Xybern

Identity & authorisation infrastructure for AI agents. Install once — Xybern discovers every AI agent in your system, gives each a cryptographic identity, and (when you turn enforcement on) authorises every action before it executes.

pip install xybern
xybern login          # browser device-code flow (auto-links your workspace)
from xybern import auto
auto.connect()        # discovers frameworks + agents + tools, registers them, instruments them
✓ Detected frameworks: CrewAI, LangGraph, 2 MCP servers
✓ Found 12 agents · 48 tools
✓ Registered to workspace "Acme Corp" (each issued a cryptographic identity)
✓ Mode: OBSERVE — actions logged, nothing blocked yet

Where to add it

Add these two lines once, at your app's startup — before your agents run. That's the whole integration.

from xybern import auto
auto.connect()
# ... then your normal code: build agents, run the crew/graph, serve, etc.
Your setup Where to put it
Agent script (CrewAI / LangChain / OpenAI Agents / LlamaIndex) Top of your main file, before creating agents
FastAPI Right after app = FastAPI()
Celery In the Celery app module (runs in each worker)
MCP server Top of the server entry, before serving tools
Django An AppConfig.ready() or wsgi.py
Jupyter First cell

Multi-process (gunicorn / multiple Celery workers): run it in the module each worker imports, so every process is covered.

What it does

  • Auto-discovery — detects and instruments LangChain, CrewAI, OpenAI Agents SDK, MCP servers, LangGraph, AutoGen, Semantic Kernel, LlamaIndex (and FastAPI/Celery). No manual wiring; agents appear in your Xybern dashboard as your app creates them.
  • Cryptographic identity — every discovered agent is registered and issued an identity, so its actions are attributable and signable.
  • Authorisation before execution — each tool/agent action passes through Xybern's policy engine; allow / block / escalate.
  • Observe-first & fail-open — default mode only logs (never blocks). When you switch to enforce, the SDK fails open if Xybern is unreachable, so it can't take your agents down.
  • Privacy — sends content hashes by default, not raw payloads.

Modes

auto.connect()                 # OBSERVE (default): log + inventory, never blocks
auto.connect(mode="enforce")   # authorise actions (allow/block/escalate)

or persist it: xybern enforce on / xybern enforce off.

CLI

xybern login [--api-key xb_...]   # device-code flow, or paste a key / set XYBERN_API_KEY
xybern agents                     # dry-run: what would be discovered
xybern doctor                     # per-framework enforcement coverage
xybern status
xybern enforce on|off
xybern logout

Auth options

  1. Device code — xybern login opens a browser; approve + pick a workspace; a scoped key is minted and stored in ~/.xybern/credentials.json.
  2. API key — xybern login --api-key xb_..., or export XYBERN_API_KEY=xb_..., or auto.connect(api_key="xb_...").

Configuration

Option Default Meaning
mode observe observe (log only) or enforce (act on decisions)
fail_open True in observe, False in enforce allow actions through if Xybern is unreachable (enforce mode)
redact False send only a SHA-256 of the content (XYBERN_REDACT=1). Content-pattern and semantic mandates cannot evaluate hashed content; for residency use a relay or dedicated deployment instead
frameworks all restrict to specific frameworks

Docs: https://docs.xybern.com/authorization/sdk

Metadata

Release files for xybern 2.17.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xybern 2.17.0
File Size Uploaded Provenance Actions
xybern-2.17.0.tar.gz 60.3 kB Without provenance Details for xybern-2.17.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for xybern 2.17.0
File Interpreter ABI Platform Actions
xybern-2.17.0-py3-none-any.whl Python 3 none any Details for xybern-2.17.0-py3-none-any.whl

Total release size: 138.6 kB

Release files / xybern-2.17.0.tar.gz

Download URL xybern-2.17.0.tar.gz
Size 60.3 kB
Tags Source
SHA-256 checksum
How to use checksums
06214e281a0a2a9e1721eed7906d812ad0e17cdc0da7e2e30eaa11ba00c167ec
BLAKE2b-256 checksum
How to use checksums
23f8b8b1fa721a2e1b9466e30f2fbafda5e9ea51fe082da7d32da2d9dc0f47cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / xybern-2.17.0-py3-none-any.whl

Download URL xybern-2.17.0-py3-none-any.whl
Size 78.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
74d16d5dd61856021260c98b0c5d168f2662c298856d4e687fb3bf71c22a146d
BLAKE2b-256 checksum
How to use checksums
f492345a38189a6747f0a36f074492ad1a4c2aa8f99aef445a0dd154870d5124
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for xybern 2.17.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page