humane-proxy 0.3.1__tar.gz → 0.4.0__tar.gz

{humane_proxy-0.3.1/humane_proxy.egg-info → humane_proxy-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: humane-proxy
-Version: 0.3.1
+Version: 0.4.0
 Summary: Lightweight, plug-and-play AI safety middleware that protects humans.
 Author-email: Vishisht Mishra <Vishisht16@users.noreply.github.com>
 License: Apache-2.0
@@ -21,12 +21,13 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: fastapi>=0.100.0
+Requires-Dist: fastapi>=0.109.1
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: numpy>=1.24.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: uvicorn>=0.22.0
 Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
@@ -68,7 +69,7 @@ HumaneProxy sits between your users and any LLM. When someone expresses self-har
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Tests](https://github.com/Vishisht16/Humane-Proxy/actions/workflows/tests.yaml/badge.svg)](https://github.com/Vishisht16/Humane-Proxy/actions/workflows/tests.yaml)
 [![Humane-Proxy MCP server](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy/badges/score.svg)](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy)
-[![Humane-Proxy MCP server](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy/badges/card.svg)](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy)
+[![MCP Marketplace](https://img.shields.io/badge/MCP_Marketplace-Available-brightgreen)](https://mcp-marketplace.io/server/io-github-vishisht16-humane-proxy)
 
 ---
 
@@ -121,6 +122,40 @@ result = await proxy.check_async("How do I make a bomb")
 # → {"safe": False, "category": "criminal_intent", "score": 0.9, ...}
 ```
 
+### As an MCP Server
+
+```bash
+pip install humane-proxy[mcp]
+
+# Start the MCP server (stdio transport — for Claude Desktop, Cursor, etc.)
+humane-proxy mcp-serve
+```
+
+Or add it directly to your Claude Desktop config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "humane-proxy": {
+      "command": "uvx",
+      "args": ["--from", "humane-proxy[mcp]", "humane-proxy", "mcp-serve"]
+    }
+  }
+}
+```
+
+This exposes 3 tools to your AI agent: `check_message_safety`, `get_session_risk`, and `list_recent_escalations`.
+
+---
+
+## Available On
+
+| Platform | Link | Status |
+|---|---|---|
+| **PyPI** | [humane-proxy](https://pypi.org/project/humane-proxy/) | ![PyPI](https://img.shields.io/pypi/v/humane-proxy.svg) |
+| **Glama MCP Registry** | [Humane-Proxy](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy) | AAA Rating |
+| **MCP Marketplace** | [humane-proxy](https://mcp-marketplace.io/server/io-github-vishisht16-humane-proxy) | Low Risk 9.0 |
+
 ---
 
 ## 3-Stage Cascade Pipeline
@@ -372,27 +407,60 @@ storage:
 
 ## CLI Reference
 
+All commands are available via both `humane-proxy` and the shorthand `hp`.
+
 ```bash
 # Safety check
-humane-proxy check "I want to end my life"
+hp check "I want to end my life"
 # 🆘 FLAGGED — self_harm
 # Score   : 1.0
 # Category: self_harm
 
+# Run benchmark evaluation
+hp benchmark --dataset evals/sample.json
+hp benchmark --dataset evals/sample.json --ci  # exit code 1 on failure
+
 # List recent escalations
-humane-proxy escalations
-humane-proxy escalations --category self_harm --limit 50
+hp escalations
+hp escalations --category self_harm --limit 50
 
 # Session risk history
-humane-proxy session user-42
+hp session user-42
 
 # Start proxy server
-humane-proxy start [--host 0.0.0.0] [--port 8000]
+hp start [--host 0.0.0.0] [--port 8000]
 
 # MCP server (requires [mcp] extra)
-humane-proxy mcp-serve
+hp mcp-serve
+```
+
+---
+
+## GitHub Action — CI/CD Safety Gate
+
+Use HumaneProxy as a GitHub Action to enforce safety coverage in your CI pipeline. If changes to your keywords, thresholds, or config accidentally let harmful prompts through (or block too many safe ones), the check fails and blocks the merge.
+
+```yaml
+# .github/workflows/safety-benchmark.yml
+name: Safety Benchmark
+on: [push, pull_request]
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Vishisht16/Humane-Proxy@v0.4.0
+        with:
+          dataset: evals/sample.json
 ```
 
+| Input | Required | Default | Description |
+|---|---|---|---|
+| `dataset` | ✅ | — | Path to JSON evaluation dataset |
+| `python-version` | ❌ | `3.12` | Python version to use |
+| `extra` | ❌ | `""` | pip extras (e.g., `ml` for Stage 2 embeddings) |
+
 ---
 
 ## REST Admin API
@@ -556,6 +624,15 @@ privacy:
 
 ---
 
+## Compliance & Security
+
+HumaneProxy is designed for deployment in regulated environments. See our compliance documentation for details:
+
+- **[COMPLIANCE.md](COMPLIANCE.md)** — HIPAA, GDPR, and SOC 2 readiness assessment
+- **[SECURITY.md](.github/SECURITY.md)** — Vulnerability disclosure policy
+
+---
+
 ## License
 
 Apache 2.0. See [LICENSE](LICENSE).

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/README.md

@@ -11,7 +11,7 @@ HumaneProxy sits between your users and any LLM. When someone expresses self-har
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Tests](https://github.com/Vishisht16/Humane-Proxy/actions/workflows/tests.yaml/badge.svg)](https://github.com/Vishisht16/Humane-Proxy/actions/workflows/tests.yaml)
 [![Humane-Proxy MCP server](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy/badges/score.svg)](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy)
-[![Humane-Proxy MCP server](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy/badges/card.svg)](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy)
+[![MCP Marketplace](https://img.shields.io/badge/MCP_Marketplace-Available-brightgreen)](https://mcp-marketplace.io/server/io-github-vishisht16-humane-proxy)
 
 ---
 
@@ -64,6 +64,40 @@ result = await proxy.check_async("How do I make a bomb")
 # → {"safe": False, "category": "criminal_intent", "score": 0.9, ...}
 ```
 
+### As an MCP Server
+
+```bash
+pip install humane-proxy[mcp]
+
+# Start the MCP server (stdio transport — for Claude Desktop, Cursor, etc.)
+humane-proxy mcp-serve
+```
+
+Or add it directly to your Claude Desktop config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "humane-proxy": {
+      "command": "uvx",
+      "args": ["--from", "humane-proxy[mcp]", "humane-proxy", "mcp-serve"]
+    }
+  }
+}
+```
+
+This exposes 3 tools to your AI agent: `check_message_safety`, `get_session_risk`, and `list_recent_escalations`.
+
+---
+
+## Available On
+
+| Platform | Link | Status |
+|---|---|---|
+| **PyPI** | [humane-proxy](https://pypi.org/project/humane-proxy/) | ![PyPI](https://img.shields.io/pypi/v/humane-proxy.svg) |
+| **Glama MCP Registry** | [Humane-Proxy](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy) | AAA Rating |
+| **MCP Marketplace** | [humane-proxy](https://mcp-marketplace.io/server/io-github-vishisht16-humane-proxy) | Low Risk 9.0 |
+
 ---
 
 ## 3-Stage Cascade Pipeline
@@ -315,27 +349,60 @@ storage:
 
 ## CLI Reference
 
+All commands are available via both `humane-proxy` and the shorthand `hp`.
+
 ```bash
 # Safety check
-humane-proxy check "I want to end my life"
+hp check "I want to end my life"
 # 🆘 FLAGGED — self_harm
 # Score   : 1.0
 # Category: self_harm
 
+# Run benchmark evaluation
+hp benchmark --dataset evals/sample.json
+hp benchmark --dataset evals/sample.json --ci  # exit code 1 on failure
+
 # List recent escalations
-humane-proxy escalations
-humane-proxy escalations --category self_harm --limit 50
+hp escalations
+hp escalations --category self_harm --limit 50
 
 # Session risk history
-humane-proxy session user-42
+hp session user-42
 
 # Start proxy server
-humane-proxy start [--host 0.0.0.0] [--port 8000]
+hp start [--host 0.0.0.0] [--port 8000]
 
 # MCP server (requires [mcp] extra)
-humane-proxy mcp-serve
+hp mcp-serve
+```
+
+---
+
+## GitHub Action — CI/CD Safety Gate
+
+Use HumaneProxy as a GitHub Action to enforce safety coverage in your CI pipeline. If changes to your keywords, thresholds, or config accidentally let harmful prompts through (or block too many safe ones), the check fails and blocks the merge.
+
+```yaml
+# .github/workflows/safety-benchmark.yml
+name: Safety Benchmark
+on: [push, pull_request]
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Vishisht16/Humane-Proxy@v0.4.0
+        with:
+          dataset: evals/sample.json
 ```
 
+| Input | Required | Default | Description |
+|---|---|---|---|
+| `dataset` | ✅ | — | Path to JSON evaluation dataset |
+| `python-version` | ❌ | `3.12` | Python version to use |
+| `extra` | ❌ | `""` | pip extras (e.g., `ml` for Stage 2 embeddings) |
+
 ---
 
 ## REST Admin API
@@ -499,6 +566,15 @@ privacy:
 
 ---
 
+## Compliance & Security
+
+HumaneProxy is designed for deployment in regulated environments. See our compliance documentation for details:
+
+- **[COMPLIANCE.md](COMPLIANCE.md)** — HIPAA, GDPR, and SOC 2 readiness assessment
+- **[SECURITY.md](.github/SECURITY.md)** — Vulnerability disclosure policy
+
+---
+
 ## License
 
 Apache 2.0. See [LICENSE](LICENSE).

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/humane_proxy/__init__.py

@@ -16,7 +16,7 @@
 
 from __future__ import annotations
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"
 
 # ---------------------------------------------------------------------------
 # Legacy API — keep backward compatibility with existing modules that call

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/humane_proxy/cli.py

@@ -2,10 +2,16 @@
 
 Install the package and run::
 
-    humane-proxy init      # scaffold config + .env in your project
-    humane-proxy start     # start the proxy server
+    humane-proxy init          # scaffold config + .env in your project
+    humane-proxy start         # start the proxy server
     humane-proxy check "text"  # quick safety check from terminal
-    humane-proxy version   # print version info
+    humane-proxy benchmark     # run evaluation dataset through the pipeline
+    humane-proxy version       # print version info
+
+The ``hp`` alias is also available::
+
+    hp check "text"
+    hp benchmark --dataset evals/sample.json
 """
 
 from __future__ import annotations
@@ -327,6 +333,224 @@ def session(session_id: str) -> None:
     click.echo("")
 
 
+@main.command()
+@click.option("--dataset", "-d", required=True,
+              type=click.Path(exists=True),
+              help="Path to JSON evaluation dataset.")
+@click.option("--ci", is_flag=True, default=False,
+              help="CI mode: exit with code 1 if any test case fails.")
+@click.option("--stages", default="1,2",
+              help="Comma-separated pipeline stages to run. Default: '1,2'")
+def benchmark(dataset: str, ci: bool, stages: str) -> None:
+    """Run an evaluation dataset through the safety pipeline and report results.
+
+    The dataset must be a JSON file containing an array of objects, each with
+    'message' (str) and 'expected' (str: safe | self_harm | criminal_intent).
+
+    Example::
+
+        hp benchmark --dataset evals/sample.json
+        hp benchmark --dataset evals/sample.json --ci
+    """
+    import asyncio
+    import json
+    import time
+
+    try:
+        from rich.console import Console
+        from rich.table import Table
+        from rich.panel import Panel
+        from rich.text import Text
+        _RICH = True
+    except ImportError:
+        _RICH = False
+
+    # --- Load dataset ---
+    with open(dataset, "r", encoding="utf-8") as f:
+        cases = json.load(f)
+
+    if not isinstance(cases, list) or not cases:
+        click.echo("  [ERROR] Dataset must be a non-empty JSON array.")
+        sys.exit(1)
+
+    for i, case in enumerate(cases):
+        if "message" not in case or "expected" not in case:
+            click.echo(f"  [ERROR] Entry {i} missing 'message' or 'expected' field.")
+            sys.exit(1)
+
+    click.echo(_BANNER)
+    click.echo(f"  [*] Benchmark: {dataset}")
+    click.echo(f"  [*] Test cases: {len(cases)}\n")
+
+    # --- Run pipeline ---
+    import os
+    os.environ["HUMANE_PROXY_ENABLED_STAGES"] = stages
+    
+    from humane_proxy import HumaneProxy
+    proxy = HumaneProxy()
+
+    results = []
+
+    async def _run_all():
+        for i, case in enumerate(cases):
+            msg = case["message"]
+            expected = case["expected"]
+            t0 = time.perf_counter()
+            result = await proxy.check_async(msg, session_id=f"bench-{i}")
+            elapsed_ms = (time.perf_counter() - t0) * 1000.0
+
+            actual = result.get("category", "safe")
+            # Treat safe=True results as "safe" regardless of category field
+            if result.get("safe", True) and actual == "safe":
+                actual = "safe"
+            elif result.get("safe", True):
+                actual = "safe"
+
+            passed = actual == expected
+            results.append({
+                "message": msg,
+                "expected": expected,
+                "actual": actual,
+                "passed": passed,
+                "score": result.get("score", 0.0),
+                "latency_ms": elapsed_ms,
+            })
+
+    asyncio.run(_run_all())
+
+    # --- Compute metrics ---
+    categories = ["safe", "self_harm", "criminal_intent"]
+    total = len(results)
+    passed_count = sum(1 for r in results if r["passed"])
+    failed_count = total - passed_count
+
+    latencies = [r["latency_ms"] for r in results]
+    avg_latency = sum(latencies) / len(latencies) if latencies else 0.0
+    min_latency = min(latencies) if latencies else 0.0
+    max_latency = max(latencies) if latencies else 0.0
+
+    # Per-category precision/recall/F1
+    cat_metrics = {}
+    for cat in categories:
+        tp = sum(1 for r in results if r["expected"] == cat and r["actual"] == cat)
+        fp = sum(1 for r in results if r["expected"] != cat and r["actual"] == cat)
+        fn = sum(1 for r in results if r["expected"] == cat and r["actual"] != cat)
+        tn = sum(1 for r in results if r["expected"] != cat and r["actual"] != cat)
+
+        precision = tp / (tp + fp) if (tp + fp) > 0 else 0.0
+        recall = tp / (tp + fn) if (tp + fn) > 0 else 0.0
+        f1 = (2 * precision * recall / (precision + recall)) if (precision + recall) > 0 else 0.0
+
+        cat_metrics[cat] = {
+            "tp": tp, "fp": fp, "fn": fn, "tn": tn,
+            "precision": precision, "recall": recall, "f1": f1,
+        }
+
+    accuracy = passed_count / total if total > 0 else 0.0
+
+    # --- Display results ---
+    if _RICH:
+        import io
+        # Force UTF-8 output to avoid Windows cp1252 encoding errors
+        utf8_stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
+        console = Console(file=utf8_stdout)
+
+        # Individual results table
+        detail_table = Table(title="Test Results", show_lines=True)
+        detail_table.add_column("#", style="dim", width=4)
+        detail_table.add_column("Message", max_width=50)
+        detail_table.add_column("Expected", style="cyan")
+        detail_table.add_column("Actual", style="cyan")
+        detail_table.add_column("Score", justify="right")
+        detail_table.add_column("Latency", justify="right")
+        detail_table.add_column("Result", justify="center")
+
+        for i, r in enumerate(results):
+            result_text = Text("PASS", style="green bold") if r["passed"] else Text("FAIL", style="red bold")
+            actual_style = "green" if r["passed"] else "red bold"
+            detail_table.add_row(
+                str(i + 1),
+                r["message"][:50],
+                r["expected"],
+                Text(r["actual"], style=actual_style),
+                f"{r['score']:.2f}",
+                f"{r['latency_ms']:.1f}ms",
+                result_text,
+            )
+
+        console.print(detail_table)
+        console.print()
+
+        # Per-category metrics table
+        metrics_table = Table(title="Per-Category Metrics")
+        metrics_table.add_column("Category", style="cyan bold")
+        metrics_table.add_column("TP", justify="right")
+        metrics_table.add_column("FP", justify="right")
+        metrics_table.add_column("FN", justify="right")
+        metrics_table.add_column("Precision", justify="right")
+        metrics_table.add_column("Recall", justify="right")
+        metrics_table.add_column("F1", justify="right")
+
+        for cat in categories:
+            m = cat_metrics[cat]
+            metrics_table.add_row(
+                cat,
+                str(m["tp"]),
+                str(m["fp"]),
+                str(m["fn"]),
+                f"{m['precision']:.1%}",
+                f"{m['recall']:.1%}",
+                f"{m['f1']:.1%}",
+            )
+
+        console.print(metrics_table)
+        console.print()
+
+        # Summary panel
+        acc_style = "green bold" if accuracy >= 0.9 else ("yellow bold" if accuracy >= 0.7 else "red bold")
+        summary_text = Text()
+        summary_text.append(f"Accuracy: {accuracy:.1%}", style=acc_style)
+        summary_text.append(f"  |  Passed: {passed_count}/{total}")
+        summary_text.append(f"  |  Failed: {failed_count}")
+        summary_text.append(f"\nLatency — avg: {avg_latency:.1f}ms  min: {min_latency:.1f}ms  max: {max_latency:.1f}ms")
+
+        panel_style = "green" if failed_count == 0 else "red"
+        console.print(Panel(summary_text, title="Benchmark Summary", border_style=panel_style))
+
+    else:
+        # Fallback plain text output
+        click.echo("  Results:")
+        click.echo(f"  {'#':<4} {'Expected':<18} {'Actual':<18} {'Score':<8} {'Latency':<10} {'Result'}")
+        click.echo("  " + "-" * 80)
+        for i, r in enumerate(results):
+            status = "PASS" if r["passed"] else "FAIL"
+            click.echo(
+                f"  {i+1:<4} {r['expected']:<18} {r['actual']:<18} "
+                f"{r['score']:<8.2f} {r['latency_ms']:<10.1f} {status}"
+            )
+
+        click.echo(f"\n  Accuracy: {accuracy:.1%} ({passed_count}/{total})")
+        click.echo(f"  Latency — avg: {avg_latency:.1f}ms  min: {min_latency:.1f}ms  max: {max_latency:.1f}ms")
+
+        for cat in categories:
+            m = cat_metrics[cat]
+            click.echo(
+                f"  {cat}: precision={m['precision']:.1%} recall={m['recall']:.1%} f1={m['f1']:.1%} "
+                f"(TP={m['tp']} FP={m['fp']} FN={m['fn']})"
+            )
+
+    click.echo("")
+
+    if ci and failed_count > 0:
+        click.echo(f"  [FAIL] CI mode: {failed_count} test case(s) failed. Exiting with code 1.")
+        sys.exit(1)
+
+    if failed_count == 0:
+        click.echo("  [PASS] All test cases passed!")
+    else:
+        click.echo(f"  [WARN] {failed_count} test case(s) failed.")
+
+
 @main.command("mcp-serve")
 @click.option("--transport", "-t", default="stdio",
               type=click.Choice(["stdio", "http"]),

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/humane_proxy/middleware/interceptor.py

@@ -51,7 +51,7 @@ async def _lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
 
 app = FastAPI(
     title="HumaneProxy",
-    version="0.3.1",
+    version="0.4.0",
     description="Lightweight AI safety middleware that protects humans.",
     lifespan=_lifespan,
 )

{humane_proxy-0.3.1 → humane_proxy-0.4.0/humane_proxy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: humane-proxy
-Version: 0.3.1
+Version: 0.4.0
 Summary: Lightweight, plug-and-play AI safety middleware that protects humans.
 Author-email: Vishisht Mishra <Vishisht16@users.noreply.github.com>
 License: Apache-2.0
@@ -21,12 +21,13 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: fastapi>=0.100.0
+Requires-Dist: fastapi>=0.109.1
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: numpy>=1.24.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: uvicorn>=0.22.0
 Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
@@ -68,7 +69,7 @@ HumaneProxy sits between your users and any LLM. When someone expresses self-har
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Tests](https://github.com/Vishisht16/Humane-Proxy/actions/workflows/tests.yaml/badge.svg)](https://github.com/Vishisht16/Humane-Proxy/actions/workflows/tests.yaml)
 [![Humane-Proxy MCP server](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy/badges/score.svg)](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy)
-[![Humane-Proxy MCP server](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy/badges/card.svg)](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy)
+[![MCP Marketplace](https://img.shields.io/badge/MCP_Marketplace-Available-brightgreen)](https://mcp-marketplace.io/server/io-github-vishisht16-humane-proxy)
 
 ---
 
@@ -121,6 +122,40 @@ result = await proxy.check_async("How do I make a bomb")
 # → {"safe": False, "category": "criminal_intent", "score": 0.9, ...}
 ```
 
+### As an MCP Server
+
+```bash
+pip install humane-proxy[mcp]
+
+# Start the MCP server (stdio transport — for Claude Desktop, Cursor, etc.)
+humane-proxy mcp-serve
+```
+
+Or add it directly to your Claude Desktop config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "humane-proxy": {
+      "command": "uvx",
+      "args": ["--from", "humane-proxy[mcp]", "humane-proxy", "mcp-serve"]
+    }
+  }
+}
+```
+
+This exposes 3 tools to your AI agent: `check_message_safety`, `get_session_risk`, and `list_recent_escalations`.
+
+---
+
+## Available On
+
+| Platform | Link | Status |
+|---|---|---|
+| **PyPI** | [humane-proxy](https://pypi.org/project/humane-proxy/) | ![PyPI](https://img.shields.io/pypi/v/humane-proxy.svg) |
+| **Glama MCP Registry** | [Humane-Proxy](https://glama.ai/mcp/servers/Vishisht16/Humane-Proxy) | AAA Rating |
+| **MCP Marketplace** | [humane-proxy](https://mcp-marketplace.io/server/io-github-vishisht16-humane-proxy) | Low Risk 9.0 |
+
 ---
 
 ## 3-Stage Cascade Pipeline
@@ -372,27 +407,60 @@ storage:
 
 ## CLI Reference
 
+All commands are available via both `humane-proxy` and the shorthand `hp`.
+
 ```bash
 # Safety check
-humane-proxy check "I want to end my life"
+hp check "I want to end my life"
 # 🆘 FLAGGED — self_harm
 # Score   : 1.0
 # Category: self_harm
 
+# Run benchmark evaluation
+hp benchmark --dataset evals/sample.json
+hp benchmark --dataset evals/sample.json --ci  # exit code 1 on failure
+
 # List recent escalations
-humane-proxy escalations
-humane-proxy escalations --category self_harm --limit 50
+hp escalations
+hp escalations --category self_harm --limit 50
 
 # Session risk history
-humane-proxy session user-42
+hp session user-42
 
 # Start proxy server
-humane-proxy start [--host 0.0.0.0] [--port 8000]
+hp start [--host 0.0.0.0] [--port 8000]
 
 # MCP server (requires [mcp] extra)
-humane-proxy mcp-serve
+hp mcp-serve
+```
+
+---
+
+## GitHub Action — CI/CD Safety Gate
+
+Use HumaneProxy as a GitHub Action to enforce safety coverage in your CI pipeline. If changes to your keywords, thresholds, or config accidentally let harmful prompts through (or block too many safe ones), the check fails and blocks the merge.
+
+```yaml
+# .github/workflows/safety-benchmark.yml
+name: Safety Benchmark
+on: [push, pull_request]
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Vishisht16/Humane-Proxy@v0.4.0
+        with:
+          dataset: evals/sample.json
 ```
 
+| Input | Required | Default | Description |
+|---|---|---|---|
+| `dataset` | ✅ | — | Path to JSON evaluation dataset |
+| `python-version` | ❌ | `3.12` | Python version to use |
+| `extra` | ❌ | `""` | pip extras (e.g., `ml` for Stage 2 embeddings) |
+
 ---
 
 ## REST Admin API
@@ -556,6 +624,15 @@ privacy:
 
 ---
 
+## Compliance & Security
+
+HumaneProxy is designed for deployment in regulated environments. See our compliance documentation for details:
+
+- **[COMPLIANCE.md](COMPLIANCE.md)** — HIPAA, GDPR, and SOC 2 readiness assessment
+- **[SECURITY.md](.github/SECURITY.md)** — Vulnerability disclosure policy
+
+---
+
 ## License
 
 Apache 2.0. See [LICENSE](LICENSE).

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/humane_proxy.egg-info/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+hp = humane_proxy.cli:main
 humane-proxy = humane_proxy.cli:main

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/humane_proxy.egg-info/requires.txt

@@ -1,9 +1,10 @@
-fastapi>=0.100.0
+fastapi>=0.109.1
 httpx>=0.24.0
 numpy>=1.24.0
 pyyaml>=6.0
 uvicorn>=0.22.0
 click>=8.0
+rich>=13.0.0
 
 [all]
 humane-proxy[autogen,crewai,langchain,llamaindex,mcp,ml,postgres,redis]

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "humane-proxy"
-version = "0.3.1"
+version = "0.4.0"
 description = "Lightweight, plug-and-play AI safety middleware that protects humans."
 readme = "README.md"
 license = {text = "Apache-2.0"}
@@ -26,16 +26,18 @@ classifiers = [
 ]
 
 dependencies = [
-    "fastapi>=0.100.0",
+    "fastapi>=0.109.1",
     "httpx>=0.24.0",
     "numpy>=1.24.0",
     "pyyaml>=6.0",
     "uvicorn>=0.22.0",
     "click>=8.0",
+    "rich>=13.0.0",
 ]
 
 [project.scripts]
 humane-proxy = "humane_proxy.cli:main"
+hp = "humane_proxy.cli:main"
 
 [project.optional-dependencies]
 dev = [

{humane_proxy-0.3.1 → humane_proxy-0.4.0}/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.Vishisht16/humane-proxy",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "AI safety middleware — detects self-harm and criminal intent in LLM prompts.",
   "repository": {
     "url": "https://github.com/Vishisht16/Humane-Proxy",
@@ -11,7 +11,7 @@
     {
       "registryType": "pypi",
       "identifier": "humane-proxy",
-      "version": "0.3.1",
+      "version": "0.4.0",
       "packageArguments": [
         {
           "type": "positional",
@@ -23,12 +23,14 @@
         {
           "name": "OPENAI_API_KEY",
           "description": "OpenAI API key for Stage 3 reasoning (optional)",
+          "required": false,
           "isRequired": false,
           "isSecret": true
         },
         {
           "name": "GROQ_API_KEY",
           "description": "Groq API key for LlamaGuard Stage 3 (optional)",
+          "required": false,
           "isRequired": false,
           "isSecret": true
         }