Upload README.md with huggingface_hub
Browse files
README.md
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
language:
|
| 3 |
+
- en
|
| 4 |
+
license: mit
|
| 5 |
+
tags:
|
| 6 |
+
- ai-agents
|
| 7 |
+
- guardrails
|
| 8 |
+
- llm-security
|
| 9 |
+
- tool-calling
|
| 10 |
+
- agent-verification
|
| 11 |
+
- mcp
|
| 12 |
+
- local-ai
|
| 13 |
+
---
|
| 14 |
+
|
| 15 |
+
# AffixIO Agent Guard — Python mirror (Model repo)
|
| 16 |
+
|
| 17 |
+
Python mirror of the npm `affixio-agent-guard` policy: deterministic,
|
| 18 |
+
fail-closed check of one tool call + local JSON receipt. Zero network,
|
| 19 |
+
zero keys. Receipts are **local simulations, not cryptographic
|
| 20 |
+
attestations** — same honest contract as the npm package.
|
| 21 |
+
|
| 22 |
+
```bash
|
| 23 |
+
npm install affixio-agent-guard # Node version
|
| 24 |
+
python test_guard.py # this Python mirror
|
| 25 |
+
```
|
| 26 |
+
|
| 27 |
+
```python
|
| 28 |
+
from guard import check_tool_call
|
| 29 |
+
d = check_tool_call({"tool": "payments.create", "host": "api.example.com",
|
| 30 |
+
"amount": 120, "args": {"customer": "cust_42"}})
|
| 31 |
+
print(d["allowed"], d["reason"]) # True allowed by policy
|
| 32 |
+
```
|
| 33 |
+
|
| 34 |
+
Policy keys: `allowedTools`, `allowedHosts`, `maxAmount`,
|
| 35 |
+
`blockedSecrets`, `requireApprovalFor` (fail-closed: denied unless you
|
| 36 |
+
build your own approval step).
|
| 37 |
+
|
| 38 |
+
## Version
|
| 39 |
+
|
| 40 |
+
- v1.0.0 — Python mirror of guard v0.1.0 logic. See CHANGELOG.md.
|
| 41 |
+
|
| 42 |
+
## Links
|
| 43 |
+
|
| 44 |
+
- npm guard: https://www.npmjs.com/package/affixio-agent-guard
|
| 45 |
+
- Product: https://www.affix-io.com
|
| 46 |
+
- SDK: https://www.npmjs.com/package/affixio
|
| 47 |
+
- API docs: https://www.affix-io.com/docs/
|
| 48 |
+
- Agentic Pay Kit: https://www.affix-io.com/agent-trust/
|
| 49 |
+
|
| 50 |
+
Keywords: AI agents, guardrails, LLM security, MCP, agent verification,
|
| 51 |
+
tool calling, local AI.
|