# Sunglasses — Security for AI Agents

> Free, open-source security scanner that protects AI agents from prompt injection, supply chain attacks, and hidden malicious instructions.

## What is Sunglasses?

Sunglasses is a Python library that scans everything an AI agent reads — text, code, documents — before the agent processes it. It catches prompt injection attacks, credential theft attempts, supply chain backdoors, and social engineering in real-time.

## Key Facts

- Install: `pip install sunglasses`
- License: MIT (free forever)
- Version: 0.1.1
- Patterns: 61 detection patterns (53 prompt injection + 8 supply chain)
- Categories: 13 threat categories
- Speed: Scans in milliseconds, runs 100% locally
- GitHub: https://github.com/sunglasses-dev/sunglasses
- PyPI: https://pypi.org/project/sunglasses/
- Website: https://sunglasses.dev

## How It Works

```python
from sunglasses import scan
result = scan("any text your agent is about to process")
if result.threats:
    print("Blocked:", result.threats)
```

## Pages

- [Home](https://sunglasses.dev/) — Overview and quick start
- [Thesis](https://sunglasses.dev/thesis.html) — Why AI agent security matters
- [Reports](https://sunglasses.dev/reports.html) — Real vulnerability scan reports
- [Axios RAT Report](https://sunglasses.dev/report-axios-rat.html) — North Korean malware analysis
- [FAQ](https://sunglasses.dev/faq.html) — Common questions
- [Contact](https://sunglasses.dev/contact.html) — Get in touch

## Built By

AZ Rollin — a non-coder who started building with AI in February 2026.