austinweeks/miasma repository overview

⁠🌀 Miasma

AI companies continually scrape the internet at an enormous scale, swallowing up all of its contents to use as training data for their next models. If you have a public website, they are already stealing your work.

Miasma is here to help you fight back! Spin up the server and point any malicious traffic towards it. Miasma will send poisoned training data from the poison fountain⁠ alongside multiple self-referential links. It's an endless buffet of slop for the slop machines.

Miasma is very fast and has a minimal memory footprint - you should not have to waste compute resources fending off the internet's leeches.

Please see the project's GitHub repository⁠ for more information.

⁠Quickstart

Run the image with default configuration:

docker run --rm -p 9999:9999 austinweeks/miasma:latest

Run with configuration (see the configuration section for details):

docker run --rm -p 9999:9999 austinweeks/miasma:latest --link-prefix '/naughty-bots/' --max-in-flight 30

Or, run within a docker compose cluster:

services:
  miasma:
    image: austinweeks/miasma:latest # or a specific SemVer tag
    command: ["--link-prefix", "/naughty-bots/", "--max-in-flight", "30"]
    ports:
      - 9999:9999

⁠Metrics

Miasma offers the ability to track scraper request counts per unique User-Agent. This can be useful for identifying which bots are hitting your site most heavily. Metrics are written to a SQLite database file and can be viewed at an endpoint of your choosing.

The following cluster configuration creates a persistent volume for the metrics database:

services:
  miasma:
    image: austinweeks/miasma:latest
    ports:
      - 9999:9999
    command: [
      "--metrics-endpoint", "/metrics",
      "--metrics-username", "admin_username",
      "--metrics-password", "admin_password",
      "--metrics-db-path", "/data/miasma_metrics.db",
    ]
    volumes:
      - miasma_metrics:/data

volumes:
  miasma_metrics:

⁠Configuration

Miasma can be configured via CLI flags or a config file⁠.

⁠Disclaimer

Miasma is not affiliated with the poison fountain⁠. We have no control over its responses and cannot guarantee the safety of its contents. You should never direct users towards your Miasma location.

Miasma is not responsible for any retaliation from operators of affected scrapers. It is your responsibility to comply with applicable laws and hosting provider policies. See LICENSE⁠ (GPL-v3) for full warranty & limitation of liability details.

Cover art by @cerberussaturn07⁠