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.31
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.31.tar.gz | 6.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aport_agent_guardrails_langchain-1.0.31-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.2 kB
Release files / aport_agent_guardrails_langchain-1.0.31.tar.gz
| Download URL | aport_agent_guardrails_langchain-1.0.31.tar.gz |
|---|---|
| Size | 6.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ccb11f43751274c8eff84dd06dd36caec0373cb72aae4b0aee0a71a8ea886d3
|
|
BLAKE2b-256 checksum How to use checksums |
82c33ef013078dcff1606ade00cf4f0a5d6d097b9bd371347e66cdad69b2cc93
|
| 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.31-py3-none-any.whl
| Download URL | aport_agent_guardrails_langchain-1.0.31-py3-none-any.whl |
|---|---|
| Size | 5.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d14a38b835d8ed316bbe28781c7e7885134b1a1dbc3ceca4fb4554a3ec67efe
|
|
BLAKE2b-256 checksum How to use checksums |
1260101c7ed4bd3e402b307c5bf6644ca91d54cda19bce7831c7137d2fc3039f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
