Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 7 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
# ISCC Codes Documentation Site
# ISCC - Documentation Site

[![DOI](https://zenodo.org/badge/96668860.svg)](https://zenodo.org/badge/latestdoi/96668860)
[![ISO 24138:2024](https://img.shields.io/badge/ISO-24138%3A2024-EC1C24)](https://www.iso.org/standard/77899.html)
[![Documentation](https://img.shields.io/badge/docs-iscc.codes-1a73e8)](https://iscc.codes)
[![License: CC BY 4.0](https://img.shields.io/badge/license-CC%20BY%204.0-lightgrey)](https://creativecommons.org/licenses/by/4.0/)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/iscc/iscc-codes)

| WARNING: This repository is the source for the `iscc.codes` documentation site and preserves historical ISCC Version 1.1 material for continuity. The old Python proof-of-concept code has been retired from the repository root and is not the current ISCC implementation. |
| --- |
Expand All @@ -17,8 +20,8 @@ This repository now serves three purposes:

New Python integrations should not use the old `iscc` proof-of-concept package.

- [`iscc-sdk`](https://github.com/iscc/iscc-sdk) high-level toolkit for generating ISCCs from media files. Install with `pip install iscc-sdk`.
- [`iscc-core`](https://github.com/iscc/iscc-core) lower-level implementation of the ISCC core algorithms used by the SDK. Install with `pip install iscc-core` when you need direct algorithm access.
- [`iscc-sdk`](https://github.com/iscc/iscc-sdk) - high-level toolkit for generating ISCCs from media files. Install with `pip install iscc-sdk`.
- [`iscc-core`](https://github.com/iscc/iscc-core) - lower-level implementation of the ISCC core algorithms used by the SDK. Install with `pip install iscc-core` when you need direct algorithm access.

For most application developers, start with `iscc-sdk`.

Expand Down
3 changes: 1 addition & 2 deletions docs/capabilities.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,7 @@ follow from that design.

![ISCC algorithmic design](images/iscc-algo-design3.svg){ .left }

An **ISCC-CODE** is a composite of several **ISCC-UNITs**, each produced by a distinct algorithm and
each capturing a different layer of identity or similarity. A composite ISCC-CODE contains at minimum a Data-Code and an Instance-Code. The units are
An **ISCC-CODE** is a made of several **ISCC-UNITs**, each using a distinct algorithm and capturing a different layer of identity. An ISCC-CODE contains at minimum a Data-Code and an Instance-Code. The units are
self-describing and can also be used in isolation.

</div>
Expand Down
308 changes: 127 additions & 181 deletions docs/concept.md

Large diffs are not rendered by default.

6 changes: 3 additions & 3 deletions docs/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -173,12 +173,12 @@ The ISCC is the work of a community, but a few roles are central to its history:
implementation, **Principal Editor of ISO 24138:2024**, and **Chairman of the
[ISCC Foundation](https://iscc.io)**
- **Kira Lemke** - director of the ISCC Foundation and convenor of ISO/TC 46/SC
9/WG 18 since May 2025
9/WG 18 since 05/2025
- **Martin Etzrodt** - director of the ISCC Foundation (since 2025) and a driving force
behind the BioCodes project, which brings the ISCC to scientific and bioimaging data
- **Sebastian Posth** - evangelist and early adopter of the ISCC, convenor of
ISO/TC 46/SC 9/WG 18 until May 2025
- **Sabine Rüsch** - first convenor of ISO/TC 46/SC 9/WG 18 (2019)
ISO/TC 46/SC 9/WG 18 (05/2022- 05/2025)
- **Sabine Rüsch** - first convenor of ISO/TC 46/SC 9/WG 18 (05/2019-05/2022)
- **Gregor Roschkowski** - project manager at DIN who managed the ISCC standardization
process from the German side, coordinating the national mirror committee for ISO/TC 46/SC
9/WG 18
Expand Down
Binary file modified docs/images/favicon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 7 additions & 7 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: iscc-codes
description: Open, decentralized content identification derived from the content itself.
description: Open, decentralized content identification - derived from the content itself.
authors: Titusz Pan
icon: lucide/house
hide:
- toc
---

# ISCC International Standard Content Code
# ISCC - International Standard Content Code

## Open, decentralized content identification derived from the content itself
## Open, decentralized content identification - derived from the content itself

**ISCC** ([ISO 24138:2024](https://www.iso.org/standard/77899.html)) is an open standard for content
identification that works directly from the digital file. Generate a compact, similarity-preserving
Expand Down Expand Up @@ -74,7 +74,7 @@ An **ISCC-CODE** is a composite, hierarchically structured fingerprint. It combi
content-derived **ISCC-UNITs** covering embedded metadata, normalized content, and the raw bytes.
Each unit is a compact, similarity-preserving hash.

[![ISCC algorithmic design](images/iscc-algo-design.svg)](images/iscc-algo-design.svg)
[![ISCC algorithmic design](images/iscc-algo-design3.svg)](images/iscc-algo-design3.svg)

[See the full specification →](specification.md)

Expand All @@ -85,12 +85,12 @@ Each unit is a compact, similarity-preserving hash.

## Developer entry points

- [**iscc-core**](https://github.com/iscc/iscc-core) Python reference implementation of the ISO 24138 core algorithms
- [**iscc-sdk**](https://github.com/iscc/iscc-sdk) high-level Python toolkit for generating ISCCs from media files
- [**iscc-core**](https://github.com/iscc/iscc-core) - Python reference implementation of the ISO 24138 core algorithms
- [**iscc-sdk**](https://github.com/iscc/iscc-sdk) - high-level Python toolkit for generating ISCCs from media files

See the [Resources](resources.md) page for the wider ISCC ecosystem of tools and services.

!!! note "ISCC Standard ISO 24138:2024"
!!! note "ISCC Standard - ISO 24138:2024"
The ISCC is published as [ISO 24138:2024](https://www.iso.org/standard/77899.html) by
ISO/TC 46/SC 9. Current implementation guidance lives at
[core.iscc.codes](https://core.iscc.codes) and [sdk.iscc.codes](https://sdk.iscc.codes).
25 changes: 25 additions & 0 deletions docs/javascripts/copilot.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
/**
* Mount the ISCC-AI copilot chat widget with anonymous authentication.
*
* Fetches a JWT token from the copilot-token endpoint, then mounts the
* Chainlit copilot widget with the token for cross-origin authentication.
*/
window.addEventListener("load", async function () {
if (typeof window.mountChainlitWidget !== "function") return;

var server = "https://iscc.ai";
var tokenUrl = server + "/api/copilot-token";

try {
var response = await fetch(tokenUrl);
var data = await response.json();
window.mountChainlitWidget({
chainlitServer: server,
theme: "light",
accessToken: data.accessToken,
customCssUrl: window.location.origin + "/stylesheets/copilot.css?v=1",
});
} catch (e) {
console.warn("ISCC-AI copilot: failed to fetch token", e);
}
});
2 changes: 1 addition & 1 deletion docs/license.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ icon: lucide/scale

<!-- iscc-sum:start -->

**Documentation source ISCC-SUM**: `ISCC:K4AEK2KH4GCOSSYMKR3ORSLHNCRTLTZR6NDLGJBX6N2UZRRCGHYOOHA`
**Documentation source ISCC-SUM**: `ISCC:K4AEK2KH4GCOSSYMKR3ORSLHNCRTCBBWM7JO7NF3NLKD2I66D27A2MA`

This wide ISCC-SUM identifies the documentation source tree generated with
`iscc-sum --tree docs`. The license page itself is excluded from the tree via
Expand Down
Loading
Loading