Skip to main content

Naymark

Python 3.9+ MIT License Development status NumPy OpenCV

Naymark is a small Python package for removing the supported visible watermark from Gemini-generated images. It uses a bundled image template to find matches and reconstruct the surrounding pixels.

Naymark is intended for images you created or are authorized to modify. It is an independent project and is not affiliated with Google or Gemini.

What it does

  • Finds matches for the bundled visible-watermark template across supported image scales.
  • Processes image files or OpenCV-style BGR arrays.
  • Reports match locations and scores, and can save the cleaned image.
  • Runs locally; images are not uploaded to a service.

Naymark is designed for this template, not as a general-purpose watermark remover. Pixel reconstruction is approximate, so inspect the output. It does not target invisible provenance signals; follow any disclosure or attribution requirements that apply to your images.

For developers

Install

After the package is published on PyPI:

python -m pip install naymark

Python

from naymark import remove_watermark

result = remove_watermark("input.jpg", "output.png")
print("Saved:", result.output_path)
print("Matches:", len(result.detections))

For file input, Naymark saves a sibling file named <filename>_cleaned<extension> if no output path is supplied. For array input, the cleaned image is available as result.image.

Command line

The input and output paths are required:

naymark input.jpg output.png

Optional arguments

Both tuning arguments are optional and use the defaults shown below.

Argument Default Description
--threshold FLOAT 0.6 Minimum template-match score for a detection.
--max-watermarks INTEGER 5 Maximum number of matches to remove from the image.

For example, override either or both values:

naymark input.jpg output.png --threshold 0.7
naymark input.jpg output.png --max-watermarks 3
naymark input.jpg output.png --threshold 0.7 --max-watermarks 3

For contributors

Set up a local checkout

Create and activate a virtual environment, then install Naymark in editable mode:

python -m venv .venv
python -m pip install -e .

Run tests

python -m unittest discover -s tests -v

Build distributions

python -m pip install build
python -m build

Build artifacts are written to dist/.

License

Naymark is distributed under the MIT License. See LICENSE.

Metadata

Release files for naymark 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for naymark 0.1.0
File Size Uploaded Provenance Actions
naymark-0.1.0.tar.gz 10.8 kB Without provenance Details for naymark-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for naymark 0.1.0
File Interpreter ABI Platform Actions
naymark-0.1.0-py3-none-any.whl Python 3 none any Details for naymark-0.1.0-py3-none-any.whl

Total release size: 20.6 kB

Release files / naymark-0.1.0.tar.gz

Download URL naymark-0.1.0.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f31ee79ccef873e53a75cdc72868d732e6d5a349b800b4664894fb9f44236ceb
BLAKE2b-256 checksum
How to use checksums
66a6fbb86f4415d259e9cd6d885e26d4cca8c5602ae6368fcab39b9edd0b56f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / naymark-0.1.0-py3-none-any.whl

Download URL naymark-0.1.0-py3-none-any.whl
Size 9.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8c583dcdf8e02eac85e35a61ceb17b96116d9b203463c98b5e5ed3ffc303807d
BLAKE2b-256 checksum
How to use checksums
50ba7122f9fac4bcefa192f6ab17cc046bbe98f2cc776b8f336ddc091e321774
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for naymark 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page