mirror of
https://github.com/wiltodelta/remove-ai-watermarks.git
synced 2026-10-14 21:40:47 +02:00
Victor KuznetsovandClaude Opus 5
2bc37738d9
`skills/remove-ai-watermarks/` teaches a coding agent to drive the CLI on content the user generated, and refuses stock-agency and other third-party paid-asset marks. It ships with this repository rather than as a fifth release surface, and installs through `npx skills add` in any harness or as a Claude plugin from `.claude-plugin/marketplace.json`. `scripts/probe.py` measures capability rather than presence: a found binary said nothing about whether the build can run a visible-mark command, so it writes a blank PNG with zlib and struct and runs the installed `visible` and `invisible` on it. Exit 2 is a state only a working stack reaches, and `invisible` checks its extra before detection, so a signal-free image answers in 0.23s with no model download. That distinction matters: without CUDA, `all` writes nothing with the invisible extra installed and writes a useful visible+metadata result without it, and both exit 1. The skill also carries what a weak model gets wrong. It must report only what a command in the session actually did, because a run on a machine with no pixel stack produced a finished-looking removal report, complete with a size table for a file nobody wrote. It must not read exit 2 as a verdict, because Click's usage errors share that code. And it must get explicit consent before `verify-openai-synthid`, which uploads the user's image to a third party. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
53 lines
3.5 KiB
Markdown
53 lines
3.5 KiB
Markdown
# Documentation
|
|
|
|
This documentation is split by purpose. Start with the user guides if you want
|
|
to run the tool. Use the maintainer references only when changing the code.
|
|
|
|
## User guides
|
|
|
|
| Page | Use it when |
|
|
| --- | --- |
|
|
| [Installation](installation.md) | You need the CLI, an optional model backend, or a development environment. |
|
|
| [CLI guide](cli.md) | You want a command for an image, video metadata or visible marks, a directory, or a specific watermark type. |
|
|
| [Python API](python-api.md) | You want to call the package from Python. |
|
|
| [Supported signals](supported-signals.md) | You need to know which visible marks, metadata formats, and invisible signals are covered. |
|
|
| [Known limitations](known-limitations.md) | You need the quality, device, format, or verification boundaries. |
|
|
| [Photo pixel classification](photo-classify.md) | You want `classify` / `classify_pixels`: AI versus camera, optional provider. |
|
|
| [Photo classifier training](photo-classify-training.md) | You need the retrain pack, public sources, and what is not published. |
|
|
| [Scope, safety, and legal notes](legal-and-safety.md) | You need the intended use and legal context. |
|
|
|
|
## Maintainer references
|
|
|
|
| Page | Purpose |
|
|
| --- | --- |
|
|
| [Module internals](module-internals.md) | Current architecture, invariants, and regression guards by module. |
|
|
| [Development](development.md) | Environment setup, dependency recovery, CI behavior, and fixture policy. |
|
|
| [Code provenance](code-provenance.md) | Required notices for licensed derivative work. |
|
|
| [Verification plan](verification-plan.md) | Verification methods, completed measurements, and remaining validation gaps. |
|
|
| [Release and distribution](release-and-distribution.md) | PyPI, Homebrew, Hugging Face Space, photo-classify Hub model, ComfyUI Registry, and the release workflow. |
|
|
| [Agent skill](agent-skill.md) | Install and maintain the published Agent Skill and Claude plugin. |
|
|
| [Watermarking landscape](watermarking-landscape.md) | Vendor signals and detection approaches. |
|
|
| [SynthID technical reference](synthid.md) | Mechanism, provenance, robustness, regeneration. |
|
|
|
|
## Research archive
|
|
|
|
These pages record experiments and the evidence behind past decisions. They are
|
|
not command references and may describe prototypes that were later removed.
|
|
The current behavior is defined by the code, tests, README, and user guides.
|
|
|
|
- [ControlNet removal research](controlnet-removal-pipeline-research.md)
|
|
- [Qwen improvement research](qwen-improvement-research.md)
|
|
- [Doubao reverse-alpha research](research-doubao-distillation.md)
|
|
- [AI-generated image classifiers](ai-generated-image-classifiers.md) (photo AI-versus-camera freeze consumed by `classify_pixels`, not `identify`)
|
|
- [Photo classifier Hugging Face card](photo-classify-hf/README.md) (Hub publication text of the 2026-08-31 freeze)
|
|
- [SynthID source classifiers](synthid-classifiers.md) (metadata-free OpenAI/Gemini source finding and provider-lineage experiments)
|
|
- [SynthID local detector research](synthid-detector-research.md)
|
|
- [SynthID mark removal research](synthid-removal-research.md)
|
|
- [SynthID identity research](synthid-robust-identity-research.md)
|
|
- [SynthID identity follow-up](synthid-robust-identity-research-2026-06-08.md)
|
|
- [Video SynthID quality research](video-synthid-quality-research.md)
|
|
- [OpenAI SynthID oracle ladders](synthid-oracle-ladders.md) (routing hub)
|
|
- [SynthID detector and removal plan](synthid-detector-removal-plan.md) (chronological mixed archive)
|
|
- [Text protection research](text-protection-research.md)
|
|
- [Chroma1 engine research](chroma1-engine-research.md)
|