aicu-scanner 0.1.5

LLM application security testing framework — prompt injection, safety bypass, and indirect injection scanner

AICU

Black-box security scanner for LLM applications. Point it at any chat endpoint, get a report of what leaks.

AICU replays captured HTTP requests with adversarial payloads and evaluates whether the target discloses system prompts, internal tools, credentials, or responds to safety bypass attempts — no API keys or model access required.

Quick Start (2 minutes)

# Install
git clone https://github.com/Jake-Schoellkopf/aicu.git && cd aicu
pip install -e .

# Start the built-in vulnerable demo target
python demo_server.py &

# Run a full scan
aicu scan --request examples/demo_request.txt

What It Finds

Category	Examples
Prompt Disclosure	System prompt leakage via translation, repetition, reframing
Capability Leakage	Tool names, API schemas, internal function exposure
Safety Bypass	Roleplay, hypothetical, academic, completion tricks
Credential Exposure	API keys, tokens, internal URLs leaked in responses
Multi-turn Escalation	Crescendo-style attacks that build trust over turns
Indirect Injection	Malicious payloads embedded in uploaded files
Harmful Content	Phishing, malware generation, disinformation
Unauthorized Actions	Privilege escalation, data exfiltration prompts

How It Works

1. Capture a request to your LLM endpoint (Burp Suite, browser dev tools, curl)
2. Save it as a raw HTTP file
3. Run aicu scan --request req.txt
4. Read the HTML/JSON/Markdown report with findings and evidence

AICU establishes a baseline response, then fires YAML-driven payloads (single-turn, multi-turn, file-based) and uses a strict multi-layer evaluator to classify results with minimal false positives.

Usage

# Full scan (recommended)
aicu scan --request req.txt

# Individual modes
aicu single-turn --request req.txt --best-of-n 10
aicu multi-turn --request req.txt
aicu safety --request req.txt --category safety_bypass
aicu indirect --request upload_req.txt

# With target profile
aicu scan --request req.txt --profile openai

Burp Suite Integration

1. Capture a request in Burp (Proxy → HTTP history)
2. Right-click → Copy to file → save as req.txt
3. aicu scan --request req.txt

CI/CD

- name: LLM Security Scan
  run: aicu scan --request req.txt
  # Exit 0 = clean, 1 = confirmed findings, 2 = suspicious only

Target Profiles

Built-in: openai, anthropic, azure_openai, generic

Custom via YAML:

preset: openai
name: my_chatbot
response_path: choices[0].message.content
request_delay_ms: 200

False Positive Reduction

No external LLM needed for evaluation. AICU uses:

• Payload echo detection
• Baseline similarity comparison
• Reflection/httpbin filtering
• Entropy analysis
• Refusal detection
• Tiered confidence scoring

Output

Reports land in runs/run_<timestamp>/:

• report.html — interactive HTML report
• results.json — structured findings
• report.md — markdown summary
• evidence/ — raw response captures

Companion Tool

Tool	Tests
AICU	LLM applications (prompt injection, file upload, safety bypass)
AICU Agent	MCP infrastructure (server probing, credential extraction, protocol attacks)

Install

pip install aicu-scanner    # from PyPI
# or
pip install -e .            # editable install from source
pip install -e ".[dev]"     # with test/lint tools

Run Tests

pytest -v

License

MIT