AgentWall Python Client SDK
Python client for the Vexa AgentWall AI Security Gateway & Firewall.
Routes AI agent tool calls and LLM egress through the out-of-process AgentWall proxy, enforcing default-deny policies, DLP secret redaction, prompt injection scanning, spend caps, and Human-in-the-Loop approvals without running governance logic in-process.
Installation
pip install vexaagentwall
Quick Start
Make sure agentwall is running locally (agentwall dev or via Docker / Kubernetes):
from agentwall import AgentWallClient, AgentWallDenied, AgentWallApprovalPending
# Auto-discovers local proxy at http://127.0.0.1:8080 or AGENTWALL_PROXY_URL env var
client = AgentWallClient()
# Method 1: Decorator for transparent governance
@client.governed
def read_project_file(path: str) -> str:
with open(path, "r") as f:
return f.read()
# Safe call
try:
content = read_project_file("/home/user/project/src/main.rs")
print(content)
except AgentWallDenied as e:
print(f"Blocked by policy: {e.rule_name} — {e.reason}")
except AgentWallApprovalPending as e:
print(f"Action requires human approval: {e.approval_url}")
# Method 2: Direct tool call routing
result = client.call_tool("read_file", {"path": "/home/user/project/README.md"})
print(result.data)
Async Support
import asyncio
from agentwall import AsyncAgentWallClient
async def main():
client = AsyncAgentWallClient()
@client.governed
async def async_fetch(url: str):
# Your tool logic
return "data"
res = await async_fetch("https://api.internal.corp/data")
print(res)
asyncio.run(main())
LangChain Integration
from langchain.tools import tool
from agentwall import AgentWallClient
client = AgentWallClient()
@tool
@client.governed
def query_customer_db(query: str) -> str:
"""Run read-only database query."""
return db.execute(query)
License
MIT License.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vexaagentwall-1.0.25.tar.gz.
File metadata
- Download URL: vexaagentwall-1.0.25.tar.gz
- Upload date:
- Size: 5.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
74aa76beadae56a19db5c1b1b45d5d0f02d45bb1232d6b49cfe032b9a32a9af9
|
|
| MD5 |
c3a56bdc09bd6bda7d798315f3d4d602
|
|
| BLAKE2b-256 |
2f640eca887551ab4c3ea6a612aa0a6fe90918856e80ec055f13dfc9c65d3411
|
Provenance
The following attestation bundles were made for vexaagentwall-1.0.25.tar.gz:
Publisher:
release.yml on noviqtechnologies/agentwall
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vexaagentwall-1.0.25.tar.gz -
Subject digest:
74aa76beadae56a19db5c1b1b45d5d0f02d45bb1232d6b49cfe032b9a32a9af9 - Sigstore transparency entry: 2396022171
- Sigstore integration time:
-
Permalink:
noviqtechnologies/agentwall@3f784a6e13aebbcc89c644c40a1ee4f87d64c987 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/noviqtechnologies
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@3f784a6e13aebbcc89c644c40a1ee4f87d64c987 -
Trigger Event:
push
-
Statement type:
File details
Details for the file vexaagentwall-1.0.25-py3-none-any.whl.
File metadata
- Download URL: vexaagentwall-1.0.25-py3-none-any.whl
- Upload date:
- Size: 2.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
92c35b73086bc6c33ab22c37b3a9b29e29160da8cfc8de6ac39a107c5f171b1a
|
|
| MD5 |
9d7e31f4eebd9d6bd0298baa3567a98d
|
|
| BLAKE2b-256 |
ebec9efa90fc5ad25c3b5a7ad623240a0411e68da7008f6c5789fe146e991884
|
Provenance
The following attestation bundles were made for vexaagentwall-1.0.25-py3-none-any.whl:
Publisher:
release.yml on noviqtechnologies/agentwall
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vexaagentwall-1.0.25-py3-none-any.whl -
Subject digest:
92c35b73086bc6c33ab22c37b3a9b29e29160da8cfc8de6ac39a107c5f171b1a - Sigstore transparency entry: 2396022396
- Sigstore integration time:
-
Permalink:
noviqtechnologies/agentwall@3f784a6e13aebbcc89c644c40a1ee4f87d64c987 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/noviqtechnologies
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@3f784a6e13aebbcc89c644c40a1ee4f87d64c987 -
Trigger Event:
push
-
Statement type:
