APort Agent Guardrail for LangChain
APort Agent Guardrail for LangChain/LangGraph — pre-action authorization for AI agents: an AsyncCallbackHandler that verifies every tool call against your passport and policies before execution. On deny, raises GuardrailViolation.
Install
pip install aport-agent-guardrails-langchain
Requires aport-agent-guardrails (core); installs automatically.
Setup
aport-langchain setup
- Writes config to
~/.aport/langchain/config.yaml. - Run the passport wizard with:
npx @aporthq/aport-agent-guardrails --framework=langchain.
Usage
from aport_guardrails_langchain import APortCallback, GuardrailViolation
from langchain.agents import create_agent
# Add callback to your agent
agent = create_agent(model=model, tools=tools)
try:
result = await agent.ainvoke(
{"messages": [{"role": "user", "content": "run the task"}]},
config={"callbacks": [APortCallback()]},
)
except GuardrailViolation as e:
print(f"Blocked: {e.code} - {e}")
print("Reasons:", e.reasons)
Config is auto-loaded from .aport/config.yaml or ~/.aport/langchain/config.yaml. Override with APortCallback(config_path="/path/to/config.yaml").
Config
- mode:
local|api - passport_path: path to passport JSON (local mode)
- agent_id:
ap_xxx(API mode, hosted passport) - api_url: optional; default
https://api.aport.io
Tests
cd python/langchain_adapter
pip install -e ".[dev]"
pip install -e ../aport_guardrails
pytest tests/ -v
Links
1 maintainer
Release files for aport-agent-guardrails-langchain 1.0.32
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aport_agent_guardrails_langchain-1.0.32.tar.gz | 6.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aport_agent_guardrails_langchain-1.0.32-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.7 kB
Release files / aport_agent_guardrails_langchain-1.0.32.tar.gz
| Download URL | aport_agent_guardrails_langchain-1.0.32.tar.gz |
|---|---|
| Size | 6.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
271f4065742257dd306a390cd89950a6907fa726553987bda7362bd0fd1d68f6
|
|
BLAKE2b-256 checksum How to use checksums |
a4d68d84f8da5519dcb745d3c8a3caf3c49669c643393f5d0a9b3c0cadd354d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
Release files / aport_agent_guardrails_langchain-1.0.32-py3-none-any.whl
| Download URL | aport_agent_guardrails_langchain-1.0.32-py3-none-any.whl |
|---|---|
| Size | 5.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f953fcff5c6912267a3cf4c48cdf1dbdee39c4435db4d808864f4102b89b8080
|
|
BLAKE2b-256 checksum How to use checksums |
1456d585e0696b029aa239a3cd10dc24d9a6766906ee1ab397b08a3c7398fcaf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
