Skip to main content

maisecrets

Find secrets and personal data in text. This package is the detection core of the maisecrets plugin for Claude Code and Codex, as a library without the plugin.

pip install maisecrets

It needs no other package and runs on Python 3.9 and later.

from maisecrets.detection import Active, Detector, Host, NO_REFERENCES, NO_SOURCES

d = Detector(
    regions=Active(regions=("generic", "de"), languages=("en", "de"), source="mine"),
    sources=NO_SOURCES,
    references=NO_REFERENCES,
    host=Host(user="me", year=2026),
)
text = open("app.log", encoding="utf-8").read()
for m in d.findings(text, channel="tool"):
    print(m.type, m.kind, m.start, m.end)     # e.g. SECRET gitlab-pat 120 146

A detector with these four arguments reads nothing of the computer it runs on: no home folder, no config.

From another language: one JSON request per process

The package also runs as a command line program. It reads one JSON request on stdin and writes one JSON response on stdout. The response holds the offsets, the type and the rule of each finding, never the value.

echo '{"contract": "maisecrets.detect/1", "text": "token: ...", "channel": "tool",
       "regions": ["generic", "de"], "languages": ["en", "de"]}' | python -m maisecrets.detection

The package installs the same program as maisecrets-detect.

The schema ships with the package (maisecrets/detection/detect-1.schema.json). An unknown key, region or label language gives an error response with exit status 2.

What it finds

  • Secrets (type SECRET): API keys and tokens of many vendors, private keys, passwords and keys after a label, credentials in URLs and connection strings.
  • Personal data (89 types): e-mail addresses, phone numbers, cards, bank accounts, national ID and tax numbers of the regions you activate, names and addresses after a label.

It finds by rules, not by a model. It leaves documented test values (a test card, an address at example.com) alone, and it misses what a rule does not describe. maisecrets.detection.TYPES lists every type.

Metadata

Release files for maisecrets 0.9.8

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

Source distribution (sdist)

Source distribution for maisecrets 0.9.8
File Size Uploaded Provenance Actions
maisecrets-0.9.8.tar.gz 512.0 kB With provenance Details for maisecrets-0.9.8.tar.gz

Built distribution (wheel)

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

Total release size: 1.0 MB

Release files / maisecrets-0.9.8.tar.gz

Download URL maisecrets-0.9.8.tar.gz
Size 512.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fe87418a35b69736aabceb9474f081598456561b32569740cce0c136d98dae62
BLAKE2b-256 checksum
How to use checksums
b1ffaa3f7a3a54026b3b75305bddbe64d0ec01391180111e8b337f5d372bfec7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / maisecrets-0.9.8-py3-none-any.whl

Download URL maisecrets-0.9.8-py3-none-any.whl
Size 490.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
78e67afc68d487892c3dbd2204c2bdd2186226df4ba6a5d8d5818ae3d337b064
BLAKE2b-256 checksum
How to use checksums
a5a53f66dc57e3b9c80859a9fc39f4cb09e6cfc3978301221c15d9c09d45aba2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Security for maisecrets 0.9.8

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for maisecrets-0.9.8.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

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.

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