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.33
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.33.tar.gz | 6.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aport_agent_guardrails_langchain-1.0.33-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.7 kB
Release files / aport_agent_guardrails_langchain-1.0.33.tar.gz
| Download URL | aport_agent_guardrails_langchain-1.0.33.tar.gz |
|---|---|
| Size | 6.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6c8ab34168f89a30e2b4017dfb7a39fac078073240655f2690f7f25116114741
|
|
BLAKE2b-256 checksum How to use checksums |
b90f81f0d10f4dd5eaec7a3f8aa91e07838030af6a0f98c99a24efb45237397b
|
| 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.33-py3-none-any.whl
| Download URL | aport_agent_guardrails_langchain-1.0.33-py3-none-any.whl |
|---|---|
| Size | 5.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
68932a310d02c8a5ee69f143f4aefde1ef76f3d18fdc2846a44c1fbf9c893436
|
|
BLAKE2b-256 checksum How to use checksums |
dc2958a8380456f2a5323c22260fcb2f222a79130b7e1a92c860c89837235594
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
