Synthetic intelligence and machine studying (AI/ML) fashions are more and more shared throughout organizations, fine-tuned, and deployed in manufacturing programs. Cisco’s AI Protection providing features a mannequin file scanning software designed to assist organizations detect and mitigate dangers in AI provide chains by verifying their integrity, scanning for malicious payloads, and guaranteeing compliance earlier than deployment. Strengthening our capability to detect and neutralize these threats is essential for safeguarding each AI mannequin integrity and operational safety.
Python pickle recordsdata comprise a big share of ML mannequin recordsdata, however they introduce vital safety danger as a result of pickles can execute arbitrary code when loaded, even a single untrusted file can compromise a whole inference setting. The safety danger is compounded by the open and accessible nature of mannequin recordsdata within the AI developer ecosystem, the place customers can obtain and execute mannequin recordsdata from public repositories with minimal verification of their security. In an try and remediate the priority, builders have created safety scanners like ModelScan, fickling, and picklescan to detect malicious pickle recordsdata earlier than they’re loaded. As safety software builders ourselves, we all know that guaranteeing these instruments are sturdy requires steady testing and validation.
That’s tougher to perform than it sounds. The issue is that lots of the points filed towards pickle safety instruments contain detection bypasses (i.e., strategies utilized by attackers to evade evaluation). These adversarial samples exploit edge circumstances in scanner logic, and guide take a look at creation can’t match the breadth wanted to floor all doable edge circumstances.
At the moment, we’re unveiling and open sourcing pickle-fuzzer, a structure-aware fuzzer that generates adversarial pickle recordsdata to check scanner robustness. At Cisco, we’re dedicated to uplifting the ML neighborhood and advancing AI safety for everybody. Securing the AI provide chain is a essential a part of this mission, guaranteeing that each mannequin, dependency, and artifact within the ecosystem will be trusted. By brazenly sharing instruments like pickle-fuzzer, we intention to strengthen your complete ecosystem of AI safety defenses. Once we discover and repair these points collaboratively, everybody who depends on pickle scanners advantages. Our staff believes the easiest way to enhance AI safety is thru collaboration. This implies brazenly sharing instruments, testing approaches, and vulnerability findings throughout the ecosystem.
Constructing robustness from inside
When creating AI Protection’s mannequin file scanning software, one in every of our targets was to make sure that its pickle scanner might face up to real-world adversarial inputs. Conventional testing strategies, resembling utilizing recognized malicious samples or fastidiously crafted take a look at circumstances, solely validate towards threats we already perceive. However attackers hardly ever comply with recognized patterns. They probe the unknown, exploiting edge circumstances, malformed constructions, and obscure opcode mixtures that typical scanners had been by no means designed to deal with.
To actually harden our system, we wanted a method to routinely discover your complete panorama of doable pickle recordsdata, together with the unusual, malformed, and intentionally adversarial ones. That’s once we determined to construct a fuzzer!
Constructing pickle-fuzzer
Fuzzing is a software program testing method that includes producing random inputs to find out in the event that they crash or trigger different sudden habits within the goal program. Originating within the late Eighties on the College of Wisconsin-Madison, fuzzing has develop into a confirmed method for hardening software program. For easy file codecs, random byte mutations usually suffice to seek out bugs. However pickle isn’t a easy format. It’s a stack-based digital machine with 100+ opcodes throughout six protocol variations (0-5), plus a memo dictionary for monitoring object references. Naive fuzzing approaches that flip random bits will produce largely invalid pickle recordsdata that may fail validation throughout parsing, earlier than exercising any attention-grabbing code paths.
The problem was discovering a center floor. We might hand-craft take a look at circumstances, however that’s precisely what we had been making an attempt to maneuver past: it’s gradual, restricted by our creativeness, and might’t simply discover the total enter house. We might use conventional mutation-based fuzzing on current pickle recordsdata, however mutations that don’t perceive pickle semantics would doubtless break the structural constraints and fail early. We would have liked an strategy that understood pickle’s inside state constraints. That left us with structure-aware fuzzing.
Construction-aware fuzzing generates pickle recordsdata that respect the format’s guidelines:
- Maintains an accurate illustration of the stack and memo dictionary;
- Respects protocol model constraints for opcodes; and
- Produces various and sudden mixtures regardless of these constraints
We wished to create adversarial inputs that had been legitimate sufficient to achieve deep into scanner logic, however bizarre sufficient to set off edge circumstances. That’s what pickle-fuzzer does.
Inside pickle-fuzzer
To generate legitimate pickles, pickle-fuzzer implements its personal pickle digital machine (PVM) with its personal stack and memo dictionary. The technology course of works like this:
- Construct a listing of legitimate opcodes based mostly on the present protocol model, stack state, and memo state
- Randomly choose an opcode from that checklist
- Optionally mutate the opcode’s arguments based mostly on their sort and PVM constraints
- Emit the opcode
- Replace the stack and memo state based mostly on the opcode’s unwanted side effects
- Repeat till the specified pickle measurement is reached
With 100% opcode protection throughout all protocol variations, pickle-fuzzer can generate 1000’s of various pickle recordsdata per second, each exercising completely different code paths in scanners. We instantly put it to work.
Hardening AI Protection’s mannequin file scanner
We ran pickle-fuzzer towards our mannequin file scanning software first. In a short time, the fuzzer discovered edge circumstances in our memo dealing with and unhashable byte array confusion logic. Uncommon however legitimate pickle recordsdata might crash the scanner or trigger it to exit early earlier than ending its safety evaluation. Every bug was a possible approach for attackers to bypass our evaluation.
Determine 1 under exhibits memo key validation pattern bypassed our detections earlier than we hardened our scanner:

Determine 2 under exhibits unhashable byte array confusion pattern crashing our detections earlier than we hardened our scanner:

We resolved these points by including correct validation for each crashes and guaranteeing the scanner continues processing even when it encounters sudden enter. This bolstered the necessity for our scanner to deal with uncommon information gracefully as an alternative of failing. Figures 3 and 4 under exhibit that the scanner now efficiently detects each pattern recordsdata.
Determine 3. AI Protection’s mannequin file scan outcomes for memo key error proof of idea

Determine 4. AI Protection’s mannequin file scan outcomes for hashing error proof of idea
Extending to the neighborhood
After strengthening our inside tooling, we acknowledged that pickle-fuzzer might additionally assist the broader AI/ML safety ecosystem. Widespread open supply scanners resembling ModelScan, Fickling, and Picklescan are foundational to many organizations’ pickle safety workflows, together with platforms like Hugging Face, which combine third-party options. We ran our fuzzer towards these scanners to uncover potential weaknesses and assist enhance their resilience.
The fuzzer revealed that related edge circumstances existed throughout the ecosystem, surfacing a sample that highlighted the inherent complexity of safely parsing pickle recordsdata. When a number of impartial implementations encounter the identical challenges, it factors to areas the place the issue house itself is tough. After fuzzing and triage, we discovered that the scanners shared a number of related points. The problems centered round two associated patterns:
Memo Key Validation: The scanners didn’t verify whether or not memo keys existed earlier than accessing them. Referencing a non-existent memo key would trigger the scanner to crash or exit earlier than finishing its safety evaluation.
Unhashable Bytearray confusion: This system exploits how the pickle scanner handles unhashable objects from the memo dictionary. When a BYTEARRAY8 opcode introduces a bytearray within the memo, it later causes an error throughout STACK_GLOBAL processing as a result of some scanners tried so as to add it to a Python set for later processing. This manipulation crashes the scanner, disrupting evaluation and revealing a weak spot in enter validation.
In consequence, we generated some pickle samples utilizing proof of idea shared in appendix (Figures 10 and 11 under) and uploaded them to Hugging Face’s repository for automated scanning.
Hugging Face’s scanner take a look at outcomes
As proven in Figures 5 and 6 under, we noticed that even industry-grade instruments stayed “Queued” indefinitely, whereas ClamAV flagged the recordsdata as suspicious. This final result highlights how our fuzzer-generated payloads can expose stability and detection gaps in current AI mannequin safety pipelines, displaying that even trendy scanners can wrestle with unconventional or adversarial pickle constructions.
Sample1: key_error.pkl:

Determine 5. Hugging Face scan outcomes for the important thing error proof of idea
Sample2: unhash_byte.pkl:
Determine 6. Hugging Face scan outcomes for the hashing error proof of idea
Armed with our findings and evaluation, we reached out to the maintainers to report what we discovered. The response from the open supply neighborhood was glorious! Two of the three groups had been extremely responsive and collaborative in addressing the problems.
The problems have been mounted in each fickling and picklescan, and patched variations at the moment are out there. When you or your group depends on both software, we advocate updating to the unaffected variations under:
- fickling v0.1.5
- picklescan v0.0.32
This collaborative strategy strengthens your complete ML safety ecosystem. When safety instruments are extra sturdy, everybody advantages.
Open-sourcing pickle-fuzzer
At the moment, we’re releasing pickle-fuzzer as an open supply software underneath the Apache 2.0 license. Our aim is to assist your complete ML safety neighborhood construct extra sturdy and safe instruments.
Getting began
Set up is simple if in case you have Rust put in: cargo set up pickle-fuzzer. You may as well construct from supply at https://github.com/cisco-ai-defense/pickle-fuzzer
There are a number of methods pickle-fuzzer can be utilized, relying in your wants. The command line interface generates its personal pickles from scratch, whereas the Python and Rust APIs help you combine it into fashionable coverage-guided fuzzers like Atheris. Each choices are lined under.
Command line interface
The command line interface additionally helps a number of choices to regulate the technology course of:
Determine 7. pickle-fuzzer’s command line interface
Pickle-fuzzer helps single pickle file technology and corpus technology with non-compulsory mutations and pickle complexity controls.

Determine 8. instance pickle-fuzzer execution for single-file and batch technology
Combine with Atheris
Pickle-fuzzer permits you to rapidly begin fuzzing your individual scanners with minimal setup. The next instance exhibits the way to combine pickle-fuzzer with Atheris, a well-liked coverage-guided fuzzer for Python:
Determine 9. fundamental instance displaying pickle-fuzzer integration with the Atheris fuzzing framework
Key takeaways
Constructing pickle-fuzzer taught us a number of issues about securing AI/ML provide chains:
- Construction-aware fuzzing works. Random bit flipping produces rapidly rejected enter. Understanding the format and producing legitimate however uncommon inputs workouts the deep logic the place bugs conceal.
- Shared challenges want shared instruments. Once we discovered related bugs throughout a number of scanners, it confirmed that pickle parsing is tough to get proper. Open sourcing the fuzzer helps everybody sort out these challenges collectively.
- Safety instruments want testing too. Instruments meant to catch assaults must be as sturdy as doable in service of the programs they’re defending.
Future work
We’re persevering with to enhance pickle-fuzzer based mostly on what we study from utilizing it. Some areas for additional analysis that we’re exploring embrace:
- Increasing mutation methods to focus on particular vulnerability lessons
- Including assist for different serialization codecs past pickle
- CI/CD pipeline assist for steady fuzzing (right here is how we do it for pickle-fuzzer utilizing cargo-fuzz)
We welcome contributions from the neighborhood. When you discover bugs in pickle-fuzzer or have concepts for enhancements, open a problem or PR on GitHub.
Put pickle-fuzzer to work
Pickle-fuzzer began as an inside software to harden AI Protection’s mannequin file scanning software. By open sourcing it, we’re hoping it helps others construct extra sturdy pickle safety instruments. The AI/ML provide chain has actual safety challenges, and all of us profit when the instruments defending it get stronger.
When you’re constructing or utilizing pickle scanners, give pickle-fuzzer a strive. Run it towards your instruments, see what breaks, and repair these bugs earlier than attackers discover them.
To discover how we apply these ideas in manufacturing, take a look at AI Protection’s mannequin file scanning software, a part of our AI Protection platform constructed to detect and neutralize threats throughout the AI/ML lifecycle, from poisoned datasets to malicious serialized fashions.
Appendix:
Unhashable ByteArray Proof of Idea:
Determine 10. python code snippet to supply hashing error proof of idea
Memo Key Validation Proof of Idea:
Determine 11. python code snippet to supply key error proof of idea

