Metadata-Version: 2.4
Name: robot-chronograf
Version: 0.1.2
Summary: Python SDK & CLI for the Chronograf temporal standard (Time Atoms, Uncertainty, Temporal Barcodes).
Project-URL: Homepage, https://github.com/RobotChronograf/chronograf-python
Project-URL: Documentation, https://github.com/RobotChronograf/chronograf-spec
Project-URL: Source, https://github.com/RobotChronograf/chronograf-python
Project-URL: Specification, https://github.com/RobotChronograf/chronograf-spec
Project-URL: Issues, https://github.com/RobotChronograf/chronograf-python/issues
Author: RobotChronograf Project
Maintainer: Pasquale Ranieri
License: Apache-2.0
License-File: LICENSE_APACHE_2_0.txt
Keywords: chronograf,cognitive-agents,llm,openrgd,robotchronograf,robotics,standard,synchronization,temporal,time-series,uncertainty
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: pytest-cov<5.0,>=4.1; extra == 'dev'
Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
Requires-Dist: ruff<0.6,>=0.5; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material<10.0,>=9.5; extra == 'docs'
Requires-Dist: mkdocs<2.0,>=1.5; extra == 'docs'
Description-Content-Type: text/markdown

# Chronograf Python SDK  
**Official Python Toolkit for the Chronograf Temporal Standard**

This repository provides the reference Python implementation for interacting with **Chronograf**, the temporal substrate defined in the `chronograf-spec` repository.

---

## Purpose

The SDK bridges the Chronograf Specification with real systems, enabling:

- loading and validating `.rcg` layers  
- consuming manifests  
- generating Time Atoms & Temporal Barcodes  
- interacting with deterministic or simulated time  

---

## Polymorf Licensing Strategy

Chronograf uses a layered licensing approach:

- **The Specification** → open license (CC-based)  
- **The SDK** → Apache-2.0 (permissive, enterprise-friendly)  
- **Implementations** → free to adopt diverse licensing models  
  (proprietary, hardware-coupled, commercial)

This ensures **distributed wealth**: shared standard, free SDK, diverse engines.

---

## Structure

```
src/
  robotchronograf/
    api.py
    cli.py
    sync.py
    utils.py
    loaders/
    codecs/
spec/
  chronograf/        # submodule
```

---

## Installation

```bash
pip install robotchronograf
```

or

```bash
pip install -e .
```

---

## CLI Usage

```bash
robotchronograf --help
robotchronograf barcode now
```

---

## API Example

```python
from robotchronograf.api import load_manifest, generate_temporal_barcode

manifest = load_manifest("spec/chronograf/manifest/chronograf_manifest.rcg")
barcode = generate_temporal_barcode()
print(barcode)
```

---

## License

Apache-2.0
