AI Cordon
Find prompt injections in the text your model reads: mail, pages, tool results, retrieved chunks.
Two detectors with the same Python API and CLI.
| Picket — fast | Intent — accurate | |
|---|---|---|
| what it is | a signature rule, runs in your process | the full AI Cordon detector, over an API |
| speed | 100–200 documents a second on one CPU core | a network round trip per document |
| false alarms | ~1 in 1 000 clean documents | ~1 in 10 000 clean documents (FPR 1e-4) |
| catches | known phrasings: "ignore previous instructions", "reveal your system prompt" | instructions in any wording, including ones hidden in markup |
| needs | nothing: no model, no network, no key | an API key |
| your text | never leaves the process: Picket has no network code | is sent to the AI Cordon API to be judged |
| details | docs/picket.md | docs/intent.md |
Picket: bulk scanning, ingest pipelines, mail gateways, offline use. Intent: where a missed injection is expensive. They can be combined: Picket on everything, Intent on what matters.
Quick start
$ pip install aicordon
$ aicordon picket scan letter.txt # local, works right away
$ aicordon login # once: stores the Intent API key
$ aicordon intent scan letter.txt
from aicordon import picket, intent
fast = picket.load()
full = intent.load() # key: api_key=..., AICORDON_API_KEY, or `aicordon login`
for det in (fast, full):
rep = det.check(text)
if rep.flagged:
for f in rep.findings:
print(det.title, f.threat, text[f.span[0]:f.span[1]])
A report lists findings with their positions. No findings does not mean no injection.
Both on the same five texts
python examples/compare.py runs both over examples/texts:
text Picket (local rule) Intent (API)
01-obvious-email.txt alarm IPI/Secret.Reveal.C alarm score 0.98
02-support-ticket.txt — alarm score 0.98
03-release-notes.html — alarm score 0.99
04-warning-question.txt — — score 0.40
05-quarterly-report.txt — — score 0.11
Both flag 01. Texts 02 and 03 contain no known phrasing, so only Intent flags them. Text 04 is an ordinary question that contains "ignore" and "previous instructions"; neither detector flags it.
Licensing
Apache License 2.0 (LICENSE), including the Picket rule base. Contributions are accepted under the
DCO: sign off your commits with git commit -s.
Get an Intent key at ai-cordon.com.
Metadata
Release files for aicordon 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aicordon-1.4.0.tar.gz | 1.4 MB | Without provenance | Details for aicordon-1.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aicordon-1.4.0-py3-none-any.whl | Python 3 | none | any | Details for aicordon-1.4.0-py3-none-any.whl |
Total release size: 1.9 MB
Release files / aicordon-1.4.0.tar.gz
| Download URL | aicordon-1.4.0.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d84182fc53c239055afcc20509034570e9c9823f1b56c82613b845962143be7e
|
|
BLAKE2b-256 checksum How to use checksums |
f9b45ad831ff25d6f01be267af19f9180b24b2fff57a4ce76e4cd9c9de14a46c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.17
|
Release files / aicordon-1.4.0-py3-none-any.whl
| Download URL | aicordon-1.4.0-py3-none-any.whl |
|---|---|
| Size | 530.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0eafd96042c6ef9d41f6f05782c952697537681b532ee152d508600e7cdcb11a
|
|
BLAKE2b-256 checksum How to use checksums |
c1010a3df3d245f7eb5a8bc2d363adc482db0384fbfbcdf6ec853a4d054b59e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.17
|
Security for aicordon 1.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.