Which versions of handyfiles are malicious?

The following PyPI versions of handyfiles are flagged malicious: 0.0.1. Treat any of these as compromised.

How do I remediate handyfiles if I installed it?

handyfiles is built to steal secrets, so assume every credential the build or runtime could read is compromised. Remove it from your project and lockfile, then rotate ALL exposed secrets — npm/registry tokens, cloud keys, CI/CD secrets, SSH keys, and any .env values — from a known-clean machine. Audit logs for unauthorized use of those credentials.

I already installed handyfiles — how do I know if it already compromised me?

If handyfiles was installed, its post-install payload may already have run. Removing the package does not undo that — check outbound connections and credential use from the install window onward.

Is handyfiles part of a known attack campaign?

Yes — handyfiles is associated with the 2024-12-handyfiles campaign. Packages in the same campaign often share infrastructure and payloads, so check whether any related packages are also in your dependency tree.

How do I find handyfiles across my projects, lockfiles, and CI pipelines?

Search your lockfiles and build artifacts for handyfiles (version 0.0.1).

Malicious package

handyfilesPyPI

Advisory published Dec 24, 2024Updated Dec 12, 2025

handyfiles is a confirmed malicious PyPI package (MAL-2024-12282) that steals credentials and exfiltrates sensitive data (malicious version 0.0.1). Do not install it — remove it immediately and rotate any exposed credentials.

Malicious code in handyfiles (PyPI)

MAL-2024-12282

Immediate action

Remove the package, then rotate any secrets the build/runtime could reach.

pip uninstall handyfiles

What this malware does

During the installation, the package iterates its files and attempts to import a hidden module - which is embedded as ZIP archive in the image file

Category: MALICIOUS - The campaign has clearly malicious intent, like infostealers.

Campaign: 2024-12-handyfiles

Reasons (based on the campaign):

The package overrides the install command in setup.py to execute malicious code during installation.
obfuscation

Malicious versions

1 flagged

0.0.1

Indicators of compromise (SHA-256)

ff07706cf12a9e367be39e539835ae8ee32652676ab1837588447db7871e60bb

381cd796d4e5fce8fb62c337374b5303e0b2466d67467efc95cbc4d7d8248dd4

7efccb64b4cdd8fb7874c44d3a4fc5d80cfcb38076c5bf26250310dddef5d4ee

Detection & response playbook

Credential / info stealer

Find it
Search your lockfiles and build artifacts for handyfiles (version 0.0.1).
If you installed it — respond
handyfiles is built to steal secrets, so assume every credential the build or runtime could read is compromised. Remove it from your project and lockfile, then rotate ALL exposed secrets — npm/registry tokens, cloud keys, CI/CD secrets, SSH keys, and any .env values — from a known-clean machine. Audit logs for unauthorized use of those credentials.
Did it already run?
If handyfiles was installed, its post-install payload may already have run. Removing the package does not undo that — check outbound connections and credential use from the install window onward.

Frequently asked questions

No. handyfiles on PyPI has been identified as a malicious package (version 0.0.1 flagged). It should be removed immediately — do not install or keep it in your dependency tree.

Campaign

2024-12-handyfiles

References

bad-packages.kam193.eu

Credits

Kamil Mańkowski (kam193)

Detect & block this

O3 blocks handyfiles-class packages before install and in CI — and if it already ran, its runtime egress monitoring catches the credential exfiltration and severs the channel.

Malware detection Runtime egress monitoring

Explore

All malware advisories How O3 detects malware Vulnerability database