Skip to main content

iscc-lib

CI PyPI License

High-performance Python bindings for ISO 24138:2024 -- International Standard Content Code (ISCC). Built on a Rust core for speed, with a Pythonic API that is a drop-in replacement for iscc-core.

What is ISCC

The ISCC is a similarity-preserving fingerprint and identifier for digital media assets. ISCCs are generated algorithmically from digital content, just like cryptographic hashes. However, instead of using a single cryptographic hash function to identify data only, the ISCC uses various algorithms to create a composite identifier that exhibits similarity-preserving properties (soft hash).

Installation

pip install iscc-lib

Quick Start

import iscc_lib as ic

result = ic.gen_meta_code_v0("ISCC Test Document!")
print(f"Meta-Code: {result['iscc']}")

API Overview

Code Generators

Function Description
gen_meta_code_v0 Generate a Meta-Code from metadata fields
gen_text_code_v0 Generate a Text-Code from plain text
gen_image_code_v0 Generate an Image-Code from pixel data
gen_audio_code_v0 Generate an Audio-Code from Chromaprint data
gen_video_code_v0 Generate a Video-Code from frame signatures
gen_mixed_code_v0 Generate a Mixed-Code from Content-Codes
gen_data_code_v0 Generate a Data-Code from bytes or stream
gen_instance_code_v0 Generate an Instance-Code from bytes or stream
gen_iscc_code_v0 Generate a composite ISCC-CODE
gen_sum_code_v0 Generate an ISCC-SUM from a file path

Utilities

  • Text processing: text_clean, text_remove_newlines, text_trim, text_collapse
  • Algorithm primitives: alg_simhash, alg_minhash_256, alg_cdc_chunks, sliding_window
  • Soft hashing: soft_hash_video_v0
  • Encoding: encode_base64
  • Codec: iscc_decompose
  • Streaming: DataHasher, InstanceHasher, SumHasher for incremental processing
  • Diagnostics: conformance_selftest

Streaming functions (gen_data_code_v0, gen_instance_code_v0) accept both bytes and file-like objects (BinaryIO).

Links

License

Apache-2.0

Download files

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

Source Distribution

iscc_lib-0.6.0.tar.gz (118.9 kB view details)

Uploaded Source

Built Distributions

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

iscc_lib-0.6.0-cp310-abi3-win_amd64.whl (439.5 kB view details)

Uploaded CPython 3.10+Windows x86-64

iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (538.8 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ x86-64

iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (499.7 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ ARM64

iscc_lib-0.6.0-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl (987.7 kB view details)

Uploaded CPython 3.10+macOS 10.12+ universal2 (ARM64, x86-64)macOS 10.12+ x86-64macOS 11.0+ ARM64

File details

Details for the file iscc_lib-0.6.0.tar.gz.

File metadata

  • Download URL: iscc_lib-0.6.0.tar.gz
  • Upload date:
  • Size: 118.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iscc_lib-0.6.0.tar.gz
Algorithm Hash digest
SHA256 2cf59e4fd0e64d99bcbc9cd87a9c21fa5a66c9867b251eaf4616aa3f5455496b
MD5 5ae15c0665ae30c87a00d399bf8a6d49
BLAKE2b-256 e546501befe4b78312b228ed13846b95f6c5d58f39617ae36539627cae3d7d1c

See more details on using hashes here.

Provenance

The following attestation bundles were made for iscc_lib-0.6.0.tar.gz:

Publisher: release.yml on iscc/iscc-lib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iscc_lib-0.6.0-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: iscc_lib-0.6.0-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 439.5 kB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iscc_lib-0.6.0-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 99a32ecb9299f406437227943913ada09f5defc415ab052b30fa477051b82c75
MD5 866a55e19368d40bda4483eeefc7e4f0
BLAKE2b-256 34cab339340156084eba7fe49e21d4db79650a8fd054f7edc4638922b9de0b73

See more details on using hashes here.

Provenance

The following attestation bundles were made for iscc_lib-0.6.0-cp310-abi3-win_amd64.whl:

Publisher: release.yml on iscc/iscc-lib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 71b87734e2ff7d818576e3d41622cc14f486f0e63208f77cdf70e8ff0471373b
MD5 e988575334b51ef9a0984db5425737b0
BLAKE2b-256 f6856604210cd5421fff92c2b89819de63ccc4abc83847a593f66bbe390d8aa8

See more details on using hashes here.

Provenance

The following attestation bundles were made for iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on iscc/iscc-lib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 dec25a0c43fb60271d1bd18f7d83e7347565b3bc67d6609fd8d11e458a78c168
MD5 4f91b1919ef2c0d26e04c9e2ad2f1851
BLAKE2b-256 ca41e1821a873be2bf4c247805f4efcd3c5e559041b293f568d806ba1448468e

See more details on using hashes here.

Provenance

The following attestation bundles were made for iscc_lib-0.6.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on iscc/iscc-lib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iscc_lib-0.6.0-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl.

File metadata

File hashes

Hashes for iscc_lib-0.6.0-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Algorithm Hash digest
SHA256 7e07d56ec4ae38a49abc36945cdc70ff8e60958e391aae74c09187d8c79ca374
MD5 c048a8423af59211e8092948950201b4
BLAKE2b-256 5b2e51dd981edef97fba17fb81b2020187809879be5bf39b5d1803311df2fa5b

See more details on using hashes here.

Provenance

The following attestation bundles were made for iscc_lib-0.6.0-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl:

Publisher: release.yml on iscc/iscc-lib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.6.0 This release

5 files

0.5.0

4 files

0.4.0

4 files

0.3.1

4 files

0.3.0

4 files

0.2.0

4 files

0.1.0

7 files

0.0.4

7 files

0.0.3

7 files

0.0.2

7 files

0.0.1

7 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page