Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
locally and free; provider env vars only needed for the Tier 3 LLM Judge),
and the CLI section is reframed as "Train guardrails from your test
results". Contributing/CLA wording cleaned up.
- **Removed unsourced performance claims** from the README tagline, tier
diagram, and package summary ("sub-millisecond latency", per-tier timings,
"~85% of prompt injections", "~10-15% of traffic"). Until we publish
benchmarks, performance language is qualitative and architecture-grounded
only: local tiers are free with no LLM call; the Tier 3 judge is the only
tier with token cost and is invoked only on escalation.
- Package summary now reads "Multi-tier firewall for AI agents — blocks prompt
injections, jailbreaks, and scope violations with sub-millisecond latency
for most requests."
injections, jailbreaks, and scope violations; fast local tiers screen every
request, only uncertain cases reach an LLM judge."

## [0.2.1] — 2026-05-12

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<h3 align="center">humanbound-firewall</h3>

<p align="center">
Multi-tier firewall for AI agents. Blocks prompt injections, jailbreaks, and scope violations with sub-millisecond latency for most requests.
Multi-tier firewall for AI agents. Blocks prompt injections, jailbreaks, and scope violations — fast local tiers screen every request; only the uncertain ones reach an LLM judge.
<br/>
<strong>4-tier architecture</strong> &middot; <strong>pluggable models</strong> &middot; <strong>guardrails trained from your own test data</strong>
</p>
Expand Down Expand Up @@ -45,22 +45,22 @@ Every user message passes through four tiers before reaching your agent:
```
User Input
|
[ Tier 0 ] Sanitization ~0ms, free
[ Tier 0 ] Sanitization no model call, free
| Strips invisible control characters, zero-width joiners, bidi overrides.
|
[ Tier 1 ] Basic Attack Detection ~15-50ms, free
[ Tier 1 ] Basic Attack Detection local model inference, free
| Pre-trained models (DeBERTa, Azure Content Safety, Lakera, etc.)
| Pluggable ensemble — add models or APIs, configure consensus.
| Catches ~85% of prompt injections out of the box.
| Catches the bulk of generic prompt injections out of the box.
|
[ Tier 2 ] Agent-Specific Classification ~10ms, free
[ Tier 2 ] Agent-Specific Classification local model inference, free
| Trained on YOUR agent's adversarial test logs and QA data.
| Catches attacks Tier 1 misses. Fast-tracks legitimate requests.
| You provide the model — we provide the training orchestrator.
|
[ Tier 3 ] LLM Judge ~1-2s, token cost
[ Tier 3 ] LLM Judge LLM call, token cost
Deep contextual analysis against your agent's security policy.
Only called when Tiers 1-2 are uncertain (~10-15% of traffic).
Only called when Tiers 1-2 are uncertain — a small fraction of traffic.
```

Each tier either makes a confident decision or escalates. No forced decisions.
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "humanbound-firewall"
version = "0.2.2"
description = "Multi-tier firewall for AI agents — blocks prompt injections, jailbreaks, and scope violations with sub-millisecond latency for most requests"
description = "Multi-tier firewall for AI agents — blocks prompt injections, jailbreaks, and scope violations; fast local tiers screen every request, only uncertain cases reach an LLM judge"
readme = "README.md"
license = "Apache-2.0"
requires-python = ">=3.10"
Expand Down