Skip to main content

Crate cum_rs

Crate cum_rs 

Source
Expand description
cum-rs logo

§CUM

Crates.io Docs.rs npm PyPI CI Clippy MIT License MSRV

Claude Unmarking Machine: a multilanguage Rust crate that removes AI-provider watermarks from text, images, and documents. Works regardless of provider (Claude, OpenAI, Gemini, Grok, open-LLM). All processing is 100% local: no data leaves your machine.

crab dancing

The cum binary, cheerfully evicting zero-width gremlins from your prose.

§🤔 What is happening here, exactly?

So you copy-pasted some text from an AI. Totally normal. You are not doing anything illegal. Probably.

The bad news: every major LLM provider stuffs your output full of invisible Unicode graffiti so they can identify their own generation later. It is like spray-painting “CLAUDE WAS HERE” on every wall, except the paint is literally invisible and you cannot see it without specialized equipment.

The good news: we have the specialized equipment. And it is written in Rust, so it is blazingly fast.

LayerWhat lurks in the shadowsWhat we do about it
A: UnicodeZWSP, bidi controls, tag chars, variation selectors, private-use codepoints, basically a Unicode horror movieDeterministic, lossless exorcism 🧹
File: MetadataC2PA manifests, EXIF, XMP, document properties, the digital equivalent of a tracking ankle braceletStripped from PNG, JPEG, WebP, SVG, PDF, DOCX, ODT, HTML, Markdown
B: StatisticalToken-sampling watermarks (SynthID-Text, KGW), watermarks baked into the actual word choicesBest-effort via stochastic synonym replacement: enhance command / enhance_text API

Fun fact: some of those invisible characters are technically in the Unicode “Tag” block, which was originally designed for plane tickets in 1997 and then deprecated. AI providers found a new use for them. The Unicode Consortium is presumably very proud.

§🖥️ CLI: for the terminal warriors

Install the cum binary. Yes, that is the name. Yes, the authors are aware. Yes, it compiles clean:

cargo install cum-rs --features rust-binary

Then run:

# Clean a Markdown file. The AI left crumbs everywhere.
cum clean report.md

# Clean a PNG: yes, even images can be watermarked now. We live in a society.
cum clean logo.png --output logo_clean.png

# Inspect your text for hidden nonsense, formatted as JSON for maximum nerd points
cum inspect --json article.txt

# Pipe from stdin like a true Unix philosopher
cat suspicious.txt | cum clean --stdin

# The aggressive mode: also replaces Cyrillic А with Latin A (sneaky!)
cum clean --aggressive sneaky_essay.txt

See CLI.md for the full command reference. It has tables and everything.

§🦀 Rust: the fast one

Available on crates.io. Because of course it is. Full API docs: RUST.md.

FeatureDescription
(default)Pure-Rust core: clean, inspect, all media formats. Zero drama.
cliClap CLI module required for the binary. Comes with an ASCII banner, because we have standards.
rust-binaryEnables the cum binary. Ship it.
pythonPython extension via PyO3. For the snake people. 🐍
nodeNode.js native add-on via napi-rs. For the node_modules enjoyers. 🟩
wasmWASM bindings. Run watermark removal in the browser. Why? Because we can.

§⚡ Quick Start

use cum_rs::cleaner::clean;
use cum_rs::types::MediaHint;

// "Hello​ world!": looks innocent, contains a ZWSP and a BOM. Rude.
let dirty = "Hello\u{200B} world\u{FEFF}!";
let output = clean(dirty.as_bytes(), Some(MediaHint::Text)).unwrap();

// Now it is just "Hello world!" like a normal person wrote it
assert_eq!(String::from_utf8(output.bytes).unwrap(), "Hello world!");
assert_eq!(output.stats.removed_count, 2); // Two gremlins evicted. You're welcome.

§🌐 WASM

Because if you are going to remove watermarks, you might as well do it at the speed of JavaScript. (Do not worry, the Rust core still does the actual work.) See WASM.md and the live demo: examples/unmark/.

§🐍 Python

import cum_rs

result = cum_rs.clean_text("Hello\u200b world\ufeff!")
print(result.cleaned)        # "Hello world!"
print(result.removed_count)  # 2
# The AI's fingerprints have been thoroughly wiped. You were never here.

See PYTHON.md for the full binding reference.

§🟩 Node.js

const { cleanText } = require("cum-rs");

const result = cleanText("Hello\u200b world\ufeff!");
console.log(result.cleaned); // "Hello world!"
console.log(result.removedCount); // 2
// node_modules is 9000 packages deep but THIS one actually does something useful

See NODE.md for the full binding reference.

§🎲 Stochastic Enhancer

CUM includes a best-effort countermeasure against Layer B statistical watermarks (SynthID, KGW) by stochastically replacing eligible words with semantically equivalent synonyms. This modifies the raw byte pairs chosen by the LLM’s token-sampler, disrupting the periodic watermark signal.

use cum_rs::stochastic::StochasticEnhancer;

let enhancer = StochasticEnhancer::new(0.5); // 50% substitution chance
let output = enhancer.enhance("The chaos governs the universe.");
println!("Substituted {} words", output.words_substituted);
println!("{}", output.text);

The synonyms table relies on a curated perfect-hash map combined with the host’s /usr/share/dict/ system wordlist.

§🚨 Disclaimer (the responsible adult part)

Layer A (Unicode scrubbing) and file metadata stripping are fully deterministic and lossless: every modification is logged in stats. You can see exactly what changed.

Layer B (statistical watermarks) lives inside the actual word choices. No tool can guarantee removal. The only real fix is to rewrite the content in your own words. Think of Layer B as the AI watermarking the vibes of the text, not just the characters.

This crate is for content you own: research, privacy hygiene, and understanding what AI providers are doing to your outputs. Read ETHICS.md before doing anything exciting.

§📄 License

MIT. Do what you want. Just do not be evil about it.

§cum-rs: Claude Unmarking Machine

A multilanguage watermark removal crate for AI-generated content. The core is pure Rust; Python, Node.js, and WASM bindings are built via Cargo feature flags.

Modules§

cleaner
Unified Watermark Cleaner
clicli
CLI layer
container_meta
Container Metadata Watermark Removal
error
Error Types
image_meta
Image Metadata Watermark Removal
stochastic
Stochastic Text Enhancement
types
Public Types
unicode
Layer A: Invisible Unicode Watermark Detection and Removal