README.md

metadata

title: DePickle
emoji: 🔍
colorFrom: indigo
colorTo: green
sdk: gradio
sdk_version: 5.46.0
app_file: app.py
pinned: false
license: mit
short_description: safely deserialize Python pickle files and display

🥒 DePickle

DePickle is a lightweight tool to safely deserialize Python pickle files and display their contents in JSON format.
It’s designed for inspection and debugging — no arbitrary code execution, no surprises.

---

✨ Features

• 🔒 Safe: Unknown classes are mapped to harmless placeholders, instead of being executed.
• 📂 Simple: Upload a .pkl file and instantly explore its structure.
• 🔎 Transparent: Converts complex object trees into pure Python built-ins (dict, list, str), making them easy to read.
• 📥 Exportable: Download the parsed content as a JSON file for further processing.
• 🧩 Multi-pickle support: Handles files containing multiple concatenated pickle objects.

---

💡 Use Cases

• Inspect cached configs, model metadata, or experiment checkpoints.
• Debug pickle contents without risking arbitrary code execution.
• Convert pickle files into JSON for easier downstream analysis.

---

🚀 How to Use

1. Upload a .pkl file.
2. Click Deserialize Safely.
3. View the parsed JSON in the preview panel.
4. (Optional) Download the JSON file for further inspection.

---

⚠️ Note: DePickle is intended for safe inspection only.
If you need to actually execute pickled objects (e.g., with their original classes), always do so locally and only with files you fully trust.

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference