# jsonpickle/jsonpickle

Python library for serializing any arbitrary object graph into JSON. It can take almost any Python object and turn the object into JSON. Additionally, it can reconstitute the object back into Python.

Repository: https://github.com/jsonpickle/jsonpickle
Canonical: https://ross.abutalabs.com/products/jsonpickle
Homepage: https://jsonpickle.readthedocs.io/en/latest/
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: json, python, serialization, pickle, deserialization, objectstorage, bsd-3-clause
Last push: 2026-08-21T15:04:29+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 74, longevity 100
- inputs: {"age_days": 6110, "days_push": 12, "days_rel": 97, "gap_med": 35.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1318, forks 186 (observed 2026-08-28T04:04:21.207269+00:00)

## What it is
jsonpickle is a Python library that serializes arbitrary Python object graphs into JSON and deserializes them back into Python objects. It builds on existing JSON encoders like json, simplejson, and ujson, and supports complex types such as numpy arrays and pandas dataframes.

## Use cases
- serialize python objects to json
- convert object graph to human-readable json
- store python objects in s3 as queryable json
- round-trip complex python objects through json
- alternative to pickle that is readable outside python
- persist dataclass instances to json files

## When to choose
- you need to serialize complex Python objects (custom classes, numpy arrays, pandas dataframes) to JSON
- you want human-readable, platform-portable data instead of binary pickle
- you need two-way encode/decode of arbitrary object graphs

## When to avoid
- you only need to serialize plain dicts and lists - the stdlib json module suffices
- you are decoding untrusted input - jsonpickle can execute arbitrary code like pickle
- you need cross-language serialization with a strict schema - use protobuf or similar

## Facets
- artifact type: library
- maturity: stable
- function: serialization, json
- domain: developer-tools, files
- platform: python, cross-platform
- tags: object-serialization, pickle-alternative, json-encoding, object-graph, data-engineering

## Member repositories
- jsonpickle/jsonpickle (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:21.207269+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:47:58.360863+00:00, confidence not recorded.
  - readme: https://github.com/jsonpickle/jsonpickle (fetched 2026-08-28T04:04:21.207269+00:00, sha a783a3586009)
  - registry_pypi: https://pypi.org/pypi/jsonpickle/json (fetched 2026-08-29T12:07:09.404123+00:00, sha c94f9bc14022)
- Data as of 2026-08-30T08:39:29.467469+00:00.