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

pip install robotchronograf

pip install -e .

CLI Usage

robotchronograf --help
robotchronograf barcode now

API Example

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

Release files for robot-chronograf 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for robot-chronograf 0.1.2
File	Size	Uploaded
robot_chronograf-0.1.2.tar.gz	27.3 kB	Nov 28, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for robot-chronograf 0.1.2
File	Interpreter	ABI	Platform	Reset
robot_chronograf-0.1.2-py3-none-any.whl 6.3 kB Nov 28, 2025	Python 3	none	any	Details

Total release size:33.6 kB

Release files / robot_chronograf-0.1.2.tar.gz

Download URL	robot_chronograf-0.1.2.tar.gz
Size	27.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`cb994486770743f9fa7e3cc01772afe3a41e40f9474806453e09fd7ab80bab2d`
BLAKE2b-256 checksum How to use checksums	`e5476bd168518ae82d0902c6319ee5cdfd003a51f8d628a0cef0a4c032a18f77`
Upload date	Nov 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.10`

Release files / robot_chronograf-0.1.2-py3-none-any.whl

Download URL	robot_chronograf-0.1.2-py3-none-any.whl
Size	6.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`355b5000101631c9eb5de9d3ede936dd51a3768f6c19aee3a5c5503828792c80`
BLAKE2b-256 checksum How to use checksums	`f0b8a891798afb3f2ef0fe0c75c060cfd794775dc7584b129254d9abca5d0956`
Upload date	Nov 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.10`