The deadliest poison known to AI
  • Rust 86.7%
  • Lua 7.6%
  • Nix 2.6%
  • Fennel 1.2%
  • Shell 1.2%
  • Other 0.6%
Find a file
Gergely Nagy 9fdc287715
Some checks are pending
default / clippy (push) Waiting to run
lint / linting (push) Waiting to run
nftables-sys: Support foo_LIB_DIR & _INCLUDE_DIR
2026-03-09 11:23:54 +01:00
.forgejo ci: Fix the clippy job 2026-03-07 01:29:26 +01:00
debian Merge branch 'iocaine-3.x' 2026-03-08 16:31:26 +01:00
examples Remove the date from copyright headers 2026-03-01 14:10:54 +01:00
iocaine iocaine: Make clippy happy 2026-03-08 12:43:15 +01:00
iocaine-label Update fennel & ai.robots.txt 2026-03-07 01:32:42 +01:00
iocaine-nftables-sys nftables-sys: Support foo_LIB_DIR & _INCLUDE_DIR 2026-03-09 11:23:54 +01:00
iocaine-powder Replace libnftables1-sys with our own copy 2026-03-09 00:44:10 +01:00
LICENSES Replace libnftables1-sys with our own copy 2026-03-09 00:44:10 +01:00
nix nftables-sys: Use pkg-config & fix static build 2026-03-09 04:28:02 +01:00
tests Remove the date from copyright headers 2026-03-01 14:10:54 +01:00
.envrc Remove the date from copyright headers 2026-03-01 14:10:54 +01:00
.gitattributes Remove the date from copyright headers 2026-03-01 14:10:54 +01:00
.gitignore Remove the date from copyright headers 2026-03-01 14:10:54 +01:00
Cargo.lock nftables-sys: Use pkg-config & fix static build 2026-03-09 04:28:02 +01:00
Cargo.toml nftables-sys: Use pkg-config & fix static build 2026-03-09 04:28:02 +01:00
CHANGELOG.md Preparations for iocaine 3.2.1 2026-03-08 16:25:12 +01:00
flake.lock nix: Update all inputs 2026-03-05 18:53:05 +01:00
flake.nix powder: Implement firewall support 2026-03-08 23:26:05 +01:00
justfile Update fennel & ai.robots.txt 2026-03-08 16:15:55 +01:00
README.md Reword the readme somewhat 2026-01-11 00:32:42 +01:00
REUSE.toml Remove the date from copyright headers 2026-03-01 14:10:54 +01:00

iocaine

Build status Demo Documentation AI? Fuck no.

The deadliest poison known to AI.

Iocaine is a defense mechanism against unwanted scrapers, sitting between upstream resources and the fronting reverse proxy. It is designed to significantly reduce the load caused by the relentless attack of the Crawlers (mostly originating from various AI companies) in a way that does not place undue burden on benign visitors. While iocaine does support presenting a proof-of-work challenge, that should be a last resort, and even if that path is taken, the challenge is inexpensive for the human visitor.

Originally, iocaine started as a garbage generator, a tarpit, a place where the reverse proxy routed unwanted visitors, so that they'd crawl an infinite maze of garbage. Since then, it grew into a more ambitious project, and includes a scripting engine that lets the iocaine-operator tell the software how to treat each incoming request. The idea remained similar, however: keep the crawlers in the maze, and let the backend serve the real content for benign visitors.

Unlike some similar tools, iocaine does not try to make the bad bots go away, it welcomes them, into an infinite maze of garbage. It does so, because that makes it possible to serve them poisoned URLs, which in turn, makes it possible to identify bad actors even if they come back piggy-backing on a real browser. By filling their queue with junk when they visit with their simpler collectors, we can capture the browser-based scrapers in the maze too.

The garbage generator in iocaine has been engineered to require as few resources as possible, to keep it cheap, pretty much on par with serving a static file from the filesystem. The goal is to have a tool that costs next to nothing for the operator, reduces the load on upstream services, and protects them from the crawlers, while having no (or at worst, very little) effect on legit visitors, but making life of crawler operators difficult at the same time.

For more information about what this is, how it works, and how to deploy it, have a look at the dedicated website.

Lets make AI poisoning the norm. If we all do it, they won't have anything to crawl.