{"id":15165971,"url":"https://github.com/konterfai-bot/konterfai","last_synced_at":"2026-02-09T22:33:02.023Z","repository":{"id":254735067,"uuid":"836364115","full_name":"konterfai-bot/konterfai","owner":"konterfai-bot","description":"Mirror repository for https://codeberg.org/konterfai/konterfai/ All developement/issue tracking/releasing/ci/etc. happens at codeberg. This is just a mirror!","archived":false,"fork":false,"pushed_at":"2025-03-13T01:06:35.000Z","size":6475,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-22T23:00:49.176Z","etag":null,"topics":["ai","llm","ollama","ollama-client","security","security-tools"],"latest_commit_sha":null,"homepage":"https://codeberg.org/konterfai/konterfai/","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/konterfai-bot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-31T17:30:14.000Z","updated_at":"2025-02-07T09:40:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"9659da64-b020-416c-8b07-6512fca22aa2","html_url":"https://github.com/konterfai-bot/konterfai","commit_stats":null,"previous_names":["konterfai-bot/konterfai"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/konterfai-bot/konterfai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konterfai-bot%2Fkonterfai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konterfai-bot%2Fkonterfai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konterfai-bot%2Fkonterfai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konterfai-bot%2Fkonterfai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/konterfai-bot","download_url":"https://codeload.github.com/konterfai-bot/konterfai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konterfai-bot%2Fkonterfai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29283635,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T21:57:15.303Z","status":"ssl_error","status_checked_at":"2026-02-09T21:57:11.537Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","llm","ollama","ollama-client","security","security-tools"],"created_at":"2024-09-27T04:21:26.348Z","updated_at":"2026-02-09T22:33:01.992Z","avatar_url":"https://github.com/konterfai-bot.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Matrix](https://img.shields.io/matrix/konterfai%3Amatrix.org?logo=matrix)](https://app.element.io/#/room/#konterfai:matrix.org)\n[![License](https://img.shields.io/badge/License-AGPL-v3.svg)](LICENSE)\n[![status-badge](https://ci.codeberg.org/api/badges/13605/status.svg)](https://ci.codeberg.org/repos/13605)\n[![Go Report Card](https://goreportcard.com/badge/codeberg.org/konterfai/konterfai)](https://goreportcard.com/report/codeberg.org/konterfai/konterfai)\n[![codecov](https://codecov.io/github/konterfai-bot/konterfai/graph/badge.svg?token=25T5Y462Q1)](https://codecov.io/github/konterfai-bot/konterfai)\n[![Codeberg Issues](https://img.shields.io/gitea/issues/open/konterfai/konterfai?gitea_url=https%3A%2F%2Fcodeberg.org)](https://codeberg.org/konterfai/konterfai)\n[![Codeberg Release](https://img.shields.io/gitea/v/release/konterfai/konterfai?gitea_url=https%3A%2F%2Fcodeberg.org\u0026sort=semver)](https://codeberg.org/konterfai/konterfai/releases)\n\n# konterfAI\n\n(c) 2024 konterfAI\n\nkonterfAI is a proof-of-concept for a model-poisoner for LLM (Large Language Models) to generate nonsense(\"bullshit\")\ncontent suitable to degenerate these models.\n\nAlthough it's still work in progress and not yet ready for production, it already shows the concept of fighting fire\nwith fire: The backend queries a tiny\nLLM running in [ollama](https://ollama.com/) with a high ai-temperature setting to generate hallucinatory content.\nIf you wonder how this looks like, check out\nthe [example-hallucination.md](https://codeberg.org/konterfai/konterfai/src/branch/main/docs/example-hallucination.md)\nfile.\n\n**NOTE:** The developers created konterfAI not as an offensive (hacking) tool, but a countermeasure against AI-crawlers\nthat ignore robots.txt and other rules. The Tool was inspired by reports of web admins suffering from TeraByte of Data\ncaused by AI crawlers - cost that can be avoided.\n\n## License\n\nkonterfAI is licensed under the AGPL (GNU AFFERO GENERAL PUBLIC LICENSE). See [LICENSE](LICENSE) for the full license\ntext.\n\n## Get in touch\n\nJoin the [Matrix-Chat](https://app.element.io/#/room/#konterfai:matrix.org) to get in touch.\n\n## Contributing\n\nsee [CONTRIBUTING](https://codeberg.org/konterfai/konterfai/src/branch/main/docs/contributing.md).\n\n## FAQ (Frequently Asked Questions)\n\nsee [FAQ](https://codeberg.org/konterfai/konterfai/src/branch/main/docs/faq.md).\n\n## How does it work?\n\nkonterfAI is supposed to run behind a reverse-proxy, like nginx or traefik.\nThe reverse proxy needs the ability to detect the user-agent of the incoming request and filter it by a given list.\nIf there is a match the crawler will not be presented with the original content, but with the poisoned content.\nThe poisoned content is also cluttered with randomized self-references to catch the crawlers in some kind of tar-pit.\n\n![A diagram showing the basic concept of konterfAI](https://codeberg.org/konterfai/konterfai/raw/branch/main/docs/img/how_it_works.png)\n\n**Note:** Those are examples and not intended for copy \u0026 paste usage. Make sure to read them carefully and adjust them\nto your needs.\n\n## What ollama models does konterfAI ship?\n\nNone, konterfAI does not ship any models. A default model will be downloaded upon ollama start.\nIf you want to use a different model, you can pick one from the [ollama-models](https://ollama.com/models) page and\nadapt your configuration accordingly.\n\n## Building\n\n```bash\n$\u003e make build\n```\n\nFor a full list of build targets see [Makefile](https://codeberg.org/konterfai/konterfai/src/branch/main/Makefile).\n\n## How to run it?\n\n### Production deployment\n\nIf you are really brave and want to try konterfAI in a production environment, see there are two examples for\n[nginx](https://codeberg.org/konterfai/konterfai/src/branch/main/deployments/nginx)\nand [traefik](https://codeberg.org/konterfai/konterfai/src/branch/main/deployments/traefik) in the deployment-folder.\n\n**Note:** These examples are not intended for copy \u0026 paste usage.\nMake sure to read them carefully and adjust them to your needs.\n\n**WARNING:** IMPROPER CONFIGURATION WILL HAVE NEGATIVE EFFECTS ON YOUR SEO\n\n### Development\n\n**Note:** `-gpu` is optional, if you do not have an ollama-capable GPU, you can omit it.\n\n```bash\n$\u003e make start-ollama[-gpu]\n$\u003e make run\n```\n\n### Tracing\n\nsee [Tracing](https://codeberg.org/konterfai/konterfai/src/branch/main/docs/tracing.md).\n\n### Default Ports\n\nkonterfAI will start two webservers, one is the service itself, listening on port 8080.\nThe other is the statistics server, listening on port 8081. If you are running this locally from source,\nyou can access both servers via [http://localhost:8080](http://localhost:8080) and [http://localhost:8081](http://localhost:8081).\nThese ports can be changed via the `--port` and `--statistics-port` flags.\n\n### Prometheus Metrics\n\nkonterfAI exposes prometheus metrics on the `/metrics` endpoint from the statistics server.\nYou can access them via [http://localhost:8081/metrics](http://localhost:8081/metrics).\n\n### Docker\n\n**Start:**\n\n```bash\n$\u003e make start-ollama[-gpu]\n$\u003e make docker-build\n$\u003e make docker-run\n```\n\n**Stop:**\n\n```bash\n$\u003e make docker-stop\n```\n\n### Docker-Compose\n\n**Start:**\n\n```bash\n$\u003e make docker-compose-up\n```\n\n**Stop:**\n\n```bash\n$\u003e make docker-compose-down\n```\n\nFor more complex examples\nedit [docker-compose.yml](https://codeberg.org/konterfai/konterfai/src/branch/main/docker-compose-dev.yml) to suit your\nneeds.\n\n#### Pre-built Docker-Image\n\nYou can also use the pre-built docker-image from [Docker-Hub](https://hub.docker.com/r/konterfai/konterfai)\nor [Quay.io](https://quay.io/repository/konterfai/konterfai).\n\n#### Pre-built Docker-Images tags\n\n| Tag           | Description                           |\n|---------------|---------------------------------------|\n| `latest`      | The latest stable release             |\n| `v*.*.*`      | A specific version  (e.g. 0.1.0, 0.1) |\n| `latest-main` | The latest main branch build          |\n\n## Configuration\n\nkonterfAI is configured via cli-flags. For a full list of supported flags run (after [building](#building)):\n\n```bash\n$\u003e ./bin/konterfai --help\n```\n\nThe docker-image is configured via environment-variables.\nFor a full list of supported variables\nsee [docker-compose.yml](https://codeberg.org/konterfai/konterfai/src/branch/main/docker-compose-dev.yml)\nand [entrypoint.sh](https://codeberg.org/konterfai/konterfai/src/branch/main/entrypoint.sh).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonterfai-bot%2Fkonterfai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkonterfai-bot%2Fkonterfai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonterfai-bot%2Fkonterfai/lists"}