Metadata-Version: 2.4
Name: neurawall
Version: 0.1.0
Summary: AI-powered HTTP security middleware for FastAPI — 100% OWASP detection, quantum-ready
Author-email: Rishi Prasad Vagu <rishi.vagu@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Rishiprasad17/Guardrail
Project-URL: Repository, https://github.com/Rishiprasad17/Guardrail
Project-URL: Bug Reports, https://github.com/Rishiprasad17/Guardrail/issues
Keywords: security,fastapi,middleware,owasp,ai,anomaly-detection,waf,post-quantum,http,python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn>=0.27.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: starlette>=0.36.0
Provides-Extra: redis
Requires-Dist: redis>=5.0.0; extra == "redis"
Provides-Extra: jwt
Requires-Dist: python-jose[cryptography]>=3.3.0; extra == "jwt"
Provides-Extra: quantum
Requires-Dist: pennylane; extra == "quantum"
Provides-Extra: all
Requires-Dist: redis>=5.0.0; extra == "all"
Requires-Dist: python-jose[cryptography]>=3.3.0; extra == "all"

# Guardrail

**AI-powered HTTP security middleware for FastAPI.**  
Fast. Precise. Quantum-ready.

## Install

```bash
pip install -r requirements.txt
```

## Quickstart

```python
from fastapi import FastAPI
from guardrail import GuardrailMiddleware, GuardrailConfig

app = FastAPI()

config = GuardrailConfig(
    ai_enabled=True,
    anthropic_api_key="your-key-here",
    security_enabled=True,
    rate_limit_rpm=60,
)

app.add_middleware(GuardrailMiddleware, config=config)
```

## Phases

| Phase | Feature | Status |
|-------|---------|--------|
| 1 | Core HTTP interceptor, logging, latency tracking | ✅ Ready |
| 2 | AI anomaly detection (Anthropic API) | ✅ Ready |
| 3 | Rate limiting, prompt injection guard, HMAC signing | ✅ Ready |
| 4 | Redis smart cache, AI-weighted TTL | ✅ Ready |
| 5 | Post-quantum crypto (Kyber), QML scoring | 🔬 Stub (install deps) |

## Run the demo

```bash
export ANTHROPIC_API_KEY=your-key-here
uvicorn guardrail.example_app:app --reload
```

## Test

```bash
pytest guardrail/tests/ -v
```

## Phase 5 — Quantum (when ready)

```bash
pip install open-quantum-safe pennylane
```

Then enable in config:
```python
config = GuardrailConfig(
    quantum_enabled=True,
    post_quantum_crypto=True,
    qml_anomaly_model=True,
)
```

## Roadmap

- [ ] OpenTelemetry metrics export
- [ ] Dashboard UI (FastAPI + HTMX)
- [ ] Publish to PyPI as `guardrail-ai`
- [ ] CRYSTALS-Dilithium response signing
- [ ] Full QML threat model (PennyLane)
