Metadata-Version: 2.4
Name: iberos
Version: 1.0.0
Summary: Open interoperability, benchmark and provenance kit for the IberOS project
Author: Esteban Molina Ruiz
License: Apache-2.0
Project-URL: Homepage, https://zenodo.org/records/22939179
Project-URL: Repository, https://github.com/estebanmolinaruiz-art/IberOS
Project-URL: Documentation, https://estebanmolinaruiz-art.github.io/IberOS/
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE_POLICY.md
License-File: NOTICE
License-File: AUTHORS.md
Requires-Dist: jsonschema>=4.18
Dynamic: license-file

# IberOS Open Research Kit v1.00

**IberOS — created by Esteban Molina Ruiz**

IberOS is an independent, amateur research project focused on reproducible internal analysis of Iberian inscriptions.

This public kit is designed so that researchers, developers and comparable software can **inspect, validate, query and exchange IberOS results in machine-readable form**.

Primary project DOI: **10.5281/zenodo.22939179**

## What this release contains

- a Python package and command-line interface (`iberos`);
- an open JSON exchange schema for IberOS result records;
- a curated registry of 38 IberOS objects;
- family/object links used by the project;
- a verified partial mapping to live Cathalaunia/Iberika `Ixxxxx` identifiers;
- representative machine-readable case examples;
- provenance and reproducibility rules;
- a static documentation site;
- GitHub Actions templates for testing, GitHub Pages, PyPI trusted publishing and Software Heritage archival.

## Important scientific scope

This kit exposes the **interoperability, benchmark, provenance and validation layer** of IberOS.

It does **not** claim that all historical/private IberOS analysis modules are fully reimplemented in this public v1.0 package. Results imported from prior IberOS releases are versioned and explicitly labelled.

The historical Beta Final V2 metrics refer to the legacy snapshot of **3,406 ENTRY**. They are not automatically metrics of the current live Cathalaunia/Iberika corpus.

## Quick start

```bash
python -m pip install .
iberos version
iberos list-objects
iberos show-object IBR-PLM-0002
iberos family SALIR
iberos validate data/examples/tivissa.json
```

## Python API

```python
from iberos import load_registry, validate_result

objects = load_registry()
print(objects[0]["OBJECT_ID"])

ok, errors = validate_result("data/examples/tivissa.json")
print(ok, errors)
```

## Interoperability

The canonical result format is defined in:

`src/iberos/schema/iberos-result-v1.schema.json`

The intended exchange chain is:

`UPSTREAM_ID → ENTRY_ID → OBJECT_ID → LEAK_GROUP → READING → PALEO → SIMPLIFIED → MORPH → CLAIMS`

## Authorship and name

The official project name is **IberOS**.

Creator and primary maintainer: **Esteban Molina Ruiz**

Forks and derivatives should preserve attribution and clearly identify themselves as modified or unofficial.

See `NAME_AND_ATTRIBUTION_POLICY.md`.

## Licensing

- Original IberOS code: **Apache-2.0**
- Original IberOS documentation and original metadata: **CC BY 4.0**
- Third-party data, transcriptions, images and editions: retain their original terms and attribution.

The Apache license does not relicense external corpora.

See `LICENSE_POLICY.md` and `LICENSES/`.

## Cite

```text
Molina Ruiz, Esteban. IberOS: marco experimental para el análisis interno
y la validación reproducible de inscripciones ibéricas.
DOI: 10.5281/zenodo.22939179
```

Machine-readable citation metadata is in `CITATION.cff`.
