cbor2

About

This library provides encoding and decoding for the Concise Binary Object Representation (CBOR) (RFC 8949) serialization format. The specification is fully compatible with the original RFC 7049. Read the docs to learn more.

It is implemented in Rust.

Features

Simple API like the json or pickle modules
Support many CBOR tags with stdlib objects
Generic tag decoding
Shared value references including cyclic references
String references compact encoding with repeated strings replaced with indices
Extensible tagged value handling using tag_hook and object_hook on decode and default on encode.
Command-line diagnostic tool, converting CBOR file or stream to JSON python -m cbor2.tool (This is a lossy conversion, for diagnostics only)
Thorough test suite (Tested on big- and little-endian architectures)

Installation

The simplest way to install the library is with pip:

pip install cbor2

If this fails, see the next section.

Build requirements

If you wish to compile the code yourself, or are installing on a yet unsupported Python version or platform where there are no wheels available, you need the following pre-requisites:

Python >= 3.10 (or PyPy3 3.11+)
Rust toolchain (tested with v1.93.0)

Usage

Basic Usage

Command-line Usage

The provided command line tool (cbor2) converts CBOR data in raw binary or base64 encoding into a representation that allows printing as JSON. This is a lossy transformation as each datatype is converted into something that can be represented as a JSON value.

The tool can alternatively be invoked with python -m cbor2.tool.

Usage:

# Pass hexadecimal through xxd.
$ echo a16568656c6c6f65776f726c64 | xxd -r -ps | cbor2 --pretty
{
    "hello": "world"
}
# Decode Base64 directly
$ echo ggEC | python -m cbor2.tool --decode
[1, 2]
# Read from a file encoded in Base64
$ python -m cbor2.tool -d tests/examples.cbor.b64
{...}

It can be used in a pipeline with json processing tools like jq to allow syntax coloring, field extraction and more.

CBOR data items concatenated into a sequence can be decoded also:

$ echo ggECggMEggUG | cbor2 -d --sequence
[1, 2]
[3, 4]
[5, 6]

Multiple files can also be sent to a single output file:

$ cbor2 -o all_files.json file1.cbor file2.cbor ... fileN.cbor

Security

This library has not been tested against malicious input. In theory it should be as safe as JSON, since unlike pickle the decoder does not execute any code.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cbor2-6.1.4.tar.gz (90.8 kB view details)

Uploaded Aug 1, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

cbor2-6.1.4-cp314-cp314t-win_arm64.whl (298.4 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tWindows ARM64

cbor2-6.1.4-cp314-cp314t-win_amd64.whl (309.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tWindows x86-64

cbor2-6.1.4-cp314-cp314t-win32.whl (281.5 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tWindows x86

cbor2-6.1.4-cp314-cp314t-musllinux_1_2_x86_64.whl (527.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tmusllinux: musl 1.2+ x86-64

cbor2-6.1.4-cp314-cp314t-musllinux_1_2_aarch64.whl (511.6 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tmusllinux: musl 1.2+ ARM64

cbor2-6.1.4-cp314-cp314t-manylinux_2_28_x86_64.whl (459.8 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tmanylinux: glibc 2.28+ x86-64

cbor2-6.1.4-cp314-cp314t-manylinux_2_28_aarch64.whl (445.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tmanylinux: glibc 2.28+ ARM64

cbor2-6.1.4-cp314-cp314t-macosx_11_0_arm64.whl (401.0 kB view details)

Uploaded Aug 1, 2026 CPython 3.14tmacOS 11.0+ ARM64

cbor2-6.1.4-cp314-cp314-win_arm64.whl (304.1 kB view details)

Uploaded Aug 1, 2026 CPython 3.14Windows ARM64

cbor2-6.1.4-cp314-cp314-win_amd64.whl (313.0 kB view details)

Uploaded Aug 1, 2026 CPython 3.14Windows x86-64

cbor2-6.1.4-cp314-cp314-win32.whl (285.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.14Windows x86

cbor2-6.1.4-cp314-cp314-musllinux_1_2_x86_64.whl (531.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.14musllinux: musl 1.2+ x86-64

cbor2-6.1.4-cp314-cp314-musllinux_1_2_aarch64.whl (518.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.14musllinux: musl 1.2+ ARM64

cbor2-6.1.4-cp314-cp314-manylinux_2_28_x86_64.whl (462.4 kB view details)

Uploaded Aug 1, 2026 CPython 3.14manylinux: glibc 2.28+ x86-64

cbor2-6.1.4-cp314-cp314-manylinux_2_28_aarch64.whl (452.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.14manylinux: glibc 2.28+ ARM64

cbor2-6.1.4-cp314-cp314-macosx_11_0_arm64.whl (407.5 kB view details)

Uploaded Aug 1, 2026 CPython 3.14macOS 11.0+ ARM64

cbor2-6.1.4-cp313-cp313-win_arm64.whl (290.0 kB view details)

Uploaded Aug 1, 2026 CPython 3.13Windows ARM64

cbor2-6.1.4-cp313-cp313-win_amd64.whl (299.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.13Windows x86-64

cbor2-6.1.4-cp313-cp313-win32.whl (278.1 kB view details)

Uploaded Aug 1, 2026 CPython 3.13Windows x86

cbor2-6.1.4-cp313-cp313-musllinux_1_2_x86_64.whl (528.8 kB view details)

Uploaded Aug 1, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

cbor2-6.1.4-cp313-cp313-musllinux_1_2_aarch64.whl (516.5 kB view details)

Uploaded Aug 1, 2026 CPython 3.13musllinux: musl 1.2+ ARM64

cbor2-6.1.4-cp313-cp313-manylinux_2_28_x86_64.whl (460.4 kB view details)

Uploaded Aug 1, 2026 CPython 3.13manylinux: glibc 2.28+ x86-64

cbor2-6.1.4-cp313-cp313-manylinux_2_28_aarch64.whl (449.8 kB view details)

Uploaded Aug 1, 2026 CPython 3.13manylinux: glibc 2.28+ ARM64

cbor2-6.1.4-cp313-cp313-macosx_11_0_arm64.whl (403.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.13macOS 11.0+ ARM64

cbor2-6.1.4-cp312-cp312-win_arm64.whl (290.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.12Windows ARM64

cbor2-6.1.4-cp312-cp312-win_amd64.whl (300.0 kB view details)

Uploaded Aug 1, 2026 CPython 3.12Windows x86-64

cbor2-6.1.4-cp312-cp312-win32.whl (278.8 kB view details)

Uploaded Aug 1, 2026 CPython 3.12Windows x86

cbor2-6.1.4-cp312-cp312-musllinux_1_2_x86_64.whl (529.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

cbor2-6.1.4-cp312-cp312-musllinux_1_2_aarch64.whl (516.9 kB view details)

Uploaded Aug 1, 2026 CPython 3.12musllinux: musl 1.2+ ARM64

cbor2-6.1.4-cp312-cp312-manylinux_2_28_x86_64.whl (461.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.12manylinux: glibc 2.28+ x86-64

cbor2-6.1.4-cp312-cp312-manylinux_2_28_aarch64.whl (449.9 kB view details)

Uploaded Aug 1, 2026 CPython 3.12manylinux: glibc 2.28+ ARM64

cbor2-6.1.4-cp312-cp312-macosx_11_0_arm64.whl (404.6 kB view details)

Uploaded Aug 1, 2026 CPython 3.12macOS 11.0+ ARM64

cbor2-6.1.4-cp311-cp311-win_arm64.whl (296.1 kB view details)

Uploaded Aug 1, 2026 CPython 3.11Windows ARM64

cbor2-6.1.4-cp311-cp311-win_amd64.whl (303.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.11Windows x86-64

cbor2-6.1.4-cp311-cp311-win32.whl (281.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.11Windows x86

cbor2-6.1.4-cp311-cp311-musllinux_1_2_x86_64.whl (532.2 kB view details)

Uploaded Aug 1, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

cbor2-6.1.4-cp311-cp311-musllinux_1_2_aarch64.whl (523.1 kB view details)

Uploaded Aug 1, 2026 CPython 3.11musllinux: musl 1.2+ ARM64

cbor2-6.1.4-cp311-cp311-manylinux_2_28_x86_64.whl (464.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.11manylinux: glibc 2.28+ x86-64

cbor2-6.1.4-cp311-cp311-manylinux_2_28_aarch64.whl (457.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.11manylinux: glibc 2.28+ ARM64

cbor2-6.1.4-cp311-cp311-macosx_11_0_arm64.whl (414.9 kB view details)

Uploaded Aug 1, 2026 CPython 3.11macOS 11.0+ ARM64

cbor2-6.1.4-cp310-cp310-win_arm64.whl (296.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.10Windows ARM64

cbor2-6.1.4-cp310-cp310-win_amd64.whl (303.8 kB view details)

Uploaded Aug 1, 2026 CPython 3.10Windows x86-64

cbor2-6.1.4-cp310-cp310-win32.whl (282.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.10Windows x86

cbor2-6.1.4-cp310-cp310-musllinux_1_2_x86_64.whl (533.4 kB view details)

Uploaded Aug 1, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

cbor2-6.1.4-cp310-cp310-musllinux_1_2_aarch64.whl (524.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.10musllinux: musl 1.2+ ARM64

cbor2-6.1.4-cp310-cp310-manylinux_2_28_x86_64.whl (464.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.10manylinux: glibc 2.28+ x86-64

cbor2-6.1.4-cp310-cp310-manylinux_2_28_aarch64.whl (458.3 kB view details)

Uploaded Aug 1, 2026 CPython 3.10manylinux: glibc 2.28+ ARM64

cbor2-6.1.4-cp310-cp310-macosx_11_0_arm64.whl (415.4 kB view details)

Uploaded Aug 1, 2026 CPython 3.10macOS 11.0+ ARM64

File details

Details for the file cbor2-6.1.4.tar.gz.

File metadata

Download URL: cbor2-6.1.4.tar.gz
Upload date: Aug 1, 2026
Size: 90.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cbor2-6.1.4.tar.gz
Algorithm	Hash digest
SHA256	`01ecc79a28f33d17331943ce508fc1e21f4b06553c73f874f4c77120d72b2ef9`
MD5	`e4f0826e14901816c8b78207fb4bc6d1`
BLAKE2b-256	`c614b02446bacfe44351b1689c04937ade007588f44570431880a6937e525e6c`

Algorithm	Hash digest
SHA256	`164ca22b509408435b2d8236c80c964e4fc77c085ab034569cd04c40d5cc8883`
MD5	`36c5dbe6dcb3992991ab78b71882da69`
BLAKE2b-256	`295fff2c6da83553a692219a0a62a21b57a27ded4405200e50db758a17fbaf15`

Algorithm	Hash digest
SHA256	`f3fc7d15cba4174373df2496070faa4a927fe3ed772130d281808120aec7b61c`
MD5	`5dfcb0ca7b888fee97df9b12ef056d99`
BLAKE2b-256	`995dd5db22837cb566de733b9d1c418cdf1912ccb1efc7b179e295430b1d81a2`

Algorithm	Hash digest
SHA256	`7deccc50fd0b55c4c7dd265b144c5358a645121e457c0ae3722b5ad59832b257`
MD5	`ac258c963f019fbf15975d707a4ff0b8`
BLAKE2b-256	`cc7c73057e7a38488a816a0d40ff9e7cd9f418800894582e2e48fb2f47ce66a2`

Algorithm	Hash digest
SHA256	`71fcf4f237d68bf4445bf45070f36f82b333f2e6a62612aa2c256683b51378a9`
MD5	`104b7dc9d19f2a81c21bd8223083393e`
BLAKE2b-256	`8266420991095d9473614b205d4c4e40b5d3b9f1ee4410eb3c48c1e902947837`

Algorithm	Hash digest
SHA256	`9b904b8d0f4ddac9259197d21d121fae4cb8b555700d65bc12c5d46a2e6c2025`
MD5	`26f593b8d739ec84a2012ac2ac3592ee`
BLAKE2b-256	`238e2015175132a27c1daed434f671ac6d9c1311461995df47f201307700e0da`

Algorithm	Hash digest
SHA256	`179a794bf4be1d46ff190695929f65f0b42019c156919846ae539d2a7ec42e54`
MD5	`3639c45f3b1fa2981295837f7fa07485`
BLAKE2b-256	`603907dd0ea957c1f48673d3947f97ee36826efd4a824053dd0ec4df2f0c89d6`

Algorithm	Hash digest
SHA256	`8f1019494b0ec81a3df3ebb01b6acb446d5b946fe35845b1726379abd66a71da`
MD5	`cdb47281b970295f6c1912da72f396dc`
BLAKE2b-256	`d51aa8624023b84b41c43a150a89517c104aed0e467bd258866f13be4c3ac0c6`

Algorithm	Hash digest
SHA256	`7336ff4cb7d161ec43b65eef43bf3e9bcab44bd152efb54dd637b7afe711254f`
MD5	`c177b193b74ee5c121809aa42e9ef214`
BLAKE2b-256	`9e413b28184154f6cbf7e47c1b7fb4a7a291c54f27a6f3a0a2f64b078c6a13e1`

Algorithm	Hash digest
SHA256	`c6b28b928c5f2dbf47dffa12dce9c8e36fe6ac1c1358bc326499c0736263b66f`
MD5	`e88730d61f27cbf9d575b8868bb84787`
BLAKE2b-256	`e5b5e614cee861772f6b5c4d926b066d2e7dbc11e220b50ba716ba91e430fb0f`

Algorithm	Hash digest
SHA256	`855764e02dc60ab9413acd044e997c3170000fdea6155d6c43a923a1d966dbe6`
MD5	`cfdc0b1b1ed170ae43c1a83911146b82`
BLAKE2b-256	`bb7d4afa096ddc94049f5a514690891b02a18319e146ceb14465ce30c8340a8b`

Algorithm	Hash digest
SHA256	`6abcf072b8c0fdc8ad7902ee26a906cafbf3427d026b662ff21166a253f85e18`
MD5	`7cff2c45d3abe314bf7186a0bf27bd5c`
BLAKE2b-256	`bdc60beac64cb74cd3217f295f9bb0d64675e1809c683a31ea2a49ac9d4d1504`

Algorithm	Hash digest
SHA256	`3f4a434c36bb0d33aeb48ddae8e8b673ca7e1f14545ee7cf4a4c7c39380ea9a2`
MD5	`0154be62666c12e318036a9eaf8399ed`
BLAKE2b-256	`7d452f5ea5bfe0fd800b3739c7df8679bdffa9f7def6b2f2fee064ada1c63e85`

Algorithm	Hash digest
SHA256	`239db0f92d537fd29eaec4e40195fc3b2b48bc34a5887059658162489a9eb6ae`
MD5	`9ae0e33cc7cc7017fb64b6fcf82f545e`
BLAKE2b-256	`9252437e4aa4f5df1fb41020d64b3d99a8239f0f99a3a75eb6ffa5cb66004b7f`

Algorithm	Hash digest
SHA256	`c0f5f2d6d3b58e44146860c049f3c082207a4005588b8926d51bf937ab66773c`
MD5	`725bc95e8636799edc44f505ee2c1c26`
BLAKE2b-256	`67228224b01f95a6fe07b1a64082aea34d9f49068392b3de93f5f3a10c73c62e`

Algorithm	Hash digest
SHA256	`0859a0837e6e2d4fe5f5b849f6475797e4db545da98c19db4b1d3487bd47aa22`
MD5	`3f6a782dd235cd9171a4dac9f2572cef`
BLAKE2b-256	`46f9b9f12a5e24d5ae355e4c0f6d37330a2bbedad3331247a223a51c4cd39d5e`

Algorithm	Hash digest
SHA256	`24da0a481294ac416e1e369e2d204b2b1d993cbd082d0d99fa3d6f5f27ae5e69`
MD5	`6017a3e70735daf27c385e6dd1c0b98a`
BLAKE2b-256	`055dc5374c76471ab41dff4420a276569a56352e83166374fba6f40fd0bde7ad`

Algorithm	Hash digest
SHA256	`598710183daae69cbdeb177a870ec64aa601de8138a61491fd256826d15a860f`
MD5	`9f1c9fc3bb6b39834d5a5707fb374c6e`
BLAKE2b-256	`5f7f35d53ff4252a5a85656480d3a81d5a5af823979ccd0c5cac95196a7548a6`

Algorithm	Hash digest
SHA256	`c08b9c7d2ea013e24a0cb819b872b0119dde404f64a1182c0b24095b7bba781f`
MD5	`f3cca59fe90681ee998aca891f4f793b`
BLAKE2b-256	`0e67ba140234a6415c16dcfbe0585ce12f905157b70e9cb1bb63a2b6d5721e70`

Algorithm	Hash digest
SHA256	`d2560c2ba6a95904ba2a0ca257af878c4344409d9b46d8e646d8ebb617b1e0dd`
MD5	`ddf193592a572ba3d6ec600d2a630641`
BLAKE2b-256	`400888cecf20b8825bdd991c47b317415c08ef9e7d5f05a1def9acd346edabde`

Algorithm	Hash digest
SHA256	`ad4efa23fee6447e56a269191044e06eb39e809458bcd674e164fe9445feafd0`
MD5	`441be4514c73b7e6a2e3a252c812af08`
BLAKE2b-256	`8286d687cd1c2c9f9a986e8552ad1fdbd22411cc86389b5705dba6ec6f7e3226`

cbor2 6.1.4

About

Features

Installation

Build requirements

Usage

Command-line Usage

Security

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Algorithm	Hash digest
SHA256	`69978901302ecbc8cda57b520487c5c5240ed217de783eb7728fceb258311d76`
MD5	`2a5cddf0948c79fea2e77186ec8ce1f2`
BLAKE2b-256	`be262cfdd5ee826205a88a826bb38b7a572c676ec3efa29574be5cdbd04b4859`

Algorithm	Hash digest
SHA256	`36ae16d64b1f7b620c1af748e7b6947e20069ef80eee56871c5fbb84cc635905`
MD5	`15b8fe5bfdf9b11905e1c2db76a26e2e`
BLAKE2b-256	`e32169e4d37f00319b3d37322355aedc83154b4d8b75dc9e9789c06e1fbd8a92`

Algorithm	Hash digest
SHA256	`4bd29f21529e279d50fc14f1a811f7b05b4d8e66a7969163cce98983b6817245`
MD5	`186d3fd944e07da6eb2542e74cb2e544`
BLAKE2b-256	`353d93eed770864540c5c9ea0841008208e9db686b7335f42520705b7d6dc6b2`

Algorithm	Hash digest
SHA256	`c48a7c938fc5fa5300ff82b5df09068dcb4838685ae8556b5ee8279d74f97ab4`
MD5	`6e52924c5883fcac07077f1770309d22`
BLAKE2b-256	`0d170b20c88e76942ede86c98cdce138681690f95908c540c264fff847729cd4`

Algorithm	Hash digest
SHA256	`553a46bda7d09552631a714e22b91e6ff2c867ecd91511596ce290d8879b8d5b`
MD5	`4ead71bb539f7ef51cfacbea950dc783`
BLAKE2b-256	`23f977981e6e63092de19d7306a09a12b0eb3fd2907dc22c10dd5d389eb27faf`

Algorithm	Hash digest
SHA256	`cc8cd300e236e9797b2e1ce306109dc481fcccf78bfa2682bf36d99e6eab1ec6`
MD5	`29cef4544f7d2201193734d16e1995ff`
BLAKE2b-256	`da2787440788fc0d9513534c3c699238e2a9ca6010f8cb72e9c203b7af20a9f6`

Algorithm	Hash digest
SHA256	`2310f07db3f9ba26f2a623774ff9f3dc7185af54f732ea119785a6b1bf7e1e7e`
MD5	`961731b87f4306ac1404f40932380ae6`
BLAKE2b-256	`918e6811e4ee84203ac657f6f461a37c7c9ba0287bde80eb83c7971e9b3fe156`

Algorithm	Hash digest
SHA256	`32a4663425fbca4a4a7aa918eb5789d844c406439e58424cf34511f79f559242`
MD5	`d0916a60a302907657b763a3b4f103a5`
BLAKE2b-256	`8c879c0959510f7a402e5995c81ccfd82cb9f314140dc0cce88c12836e5b93f1`

Algorithm	Hash digest
SHA256	`5e6c76004d674ad1c620660cb0bc5a8a0b72a5d8c7b70926d8e09e6d7e87332f`
MD5	`d2e87f4eb59cf36ea3901b5b781c5f3b`
BLAKE2b-256	`15e44445e6237088d1cca3b8536daeb90d6b4e23776de5609c9fa46773874757`

Algorithm	Hash digest
SHA256	`310f3dfb296ba48fe9b63c5cf26e691e3548a1eae6901d2f0c18e941d151f220`
MD5	`68cefe1e504ab926add495112fcef5e3`
BLAKE2b-256	`f0a510c6c126d59b07f2bd005094dd12a20afa46146f7e2673ed6f61a57641a7`