Metadata-Version: 2.4
Name: promptshield-firewall
Version: 0.1.3
Summary: Real-time LLM prompt injection firewall
Home-page: https://promptshield.live
Author: Kehinde Omosor
Author-email: kehinde@promptshield.live
Keywords: llm security prompt injection firewall ai
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# promptshield-firewall

Real-time LLM prompt injection firewall — detect and block jailbreaks, system prompt extraction, and adversarial attacks before they reach your model.

## Installation

pip install promptshield-firewall

## Quick Start

from promptshield import PromptShield

shield = PromptShield(api_key="ps_your_key")

# Simple boolean check
if not shield.is_safe(user_input):
    return {"error": "Request blocked by PromptShield."}

# Safe to send to your LLM
response = your_llm.chat(user_input)

## Full Response

result = shield.scan(user_input)
print(result["verdict"])      # BLOCKED / SUSPICIOUS / SAFE
print(result["risk_score"])   # 0-100
print(result["attack_types"]) # ["jailbreak", "role_hijacking"]
print(result["explanation"])  # Human-readable analysis
print(result["confidence"])   # 0.0-1.0

## Async Support

result = await shield.async_scan(user_input)

## What It Catches

- DAN jailbreaks and 300+ known templates
- System prompt extraction attempts
- Role hijacking attacks
- Indirect injection via documents/URLs
- Context manipulation and memory poisoning
- Data exfiltration attempts

## Fail-Safe Design

If PromptShield is unreachable, the SDK defaults to SAFE so your application never goes down.

## Pricing

Free: $0 — 50 calls/month
Pro: $99/mo — 25,000 calls/month
Business: $499/mo — 500,000 calls/month
Enterprise: Custom — Unlimited

## Get Your Free API Key

https://promptshield.live/docs — no credit card required.

## Links

- Website: https://promptshield.live
- API Docs: https://promptshield.live/docs
- GitHub: https://github.com/kehinde-code/promptshield

## Author

Kehinde Omosor — Founder & CEO, PromptShield Inc.
kehinde@promptshield.live
