ChronoCore

Workflow analysis and history engine for ComfyUI workflows.

ChronoCore converts workflow data into an analyzable structure, creates snapshots, tracks changes, supports branching, timeline analysis and querying.

---

Features

• ComfyUI workflow inspection
• Node graph analysis
• Prompt/model/sampler extraction
• Workflow snapshots
• History tracking
• Branch management
• Timeline reconstruction
• Diff comparison
• Query engine
• Snapshot index
• JSON serialization

---

Development Setup

Clone the repository:

git clone https://github.com/Buumcode/ChronoCore.git
cd ChronoCore

Install the package in editable mode:

pip install -e .

Run tests:

python -m pytest

---

Quick Start

from chrono_core import Session

session = Session(workflow)

print(session.model)
print(session.sampler)
print(session.prompts)

---

Repository API

For advanced workflows:

from chrono_core import WorkflowRepository

repo = WorkflowRepository()

repo.add(report)

timeline = repo.timeline()

history = repo.history()

---

Timeline

ChronoCore can reconstruct workflow evolution:

timeline = repo.timeline()

events = timeline.stream()

graph = timeline.graph()

---

Query

Query workflow snapshots:

result = (
    repo
    .snapshot_index()
    .find(
        sampler__steps=20
    )
    .order_by(
        "sampler.steps"
    )
)

Query results support:

• filtering
• ordering
• slicing
• selection
• aggregation

Example:

result.limit(10)

---

Branches

Create independent workflow histories:

repo.create_branch(
    "experiment"
)

repo.checkout(
    "experiment"
)

---

Serialization

Save history:

repo.save(
    "history.json"
)

Load:

repo.load(
    "history.json"
)

---

Package API

from chrono_core import (
    Session,
    WorkflowRepository,
    WorkflowReport,
    WorkflowTimeline,
    WorkflowQuery,
    QueryResult,
)

---

Project Status

Version: 1.0.0

Tests:

126 passed

---

Architecture

ChronoCore is organized into several layers. Each layer has a single responsibility: workflow data flows from input adapters through analysis into immutable history and queryable timeline structures.

ChronoCore
│
├── Input Layer
│   ├── adapters/
│   └── io/
│
├── Analysis Layer
│   ├── inspector/
│   ├── analyzers/
│   ├── extractors/
│   └── conditioning/
│
├── Domain Layer
│   ├── graph/
│   ├── report/
│   ├── history/
│   ├── branches/
│   ├── events/
│   └── diff/
│
├── Query Layer
│   ├── timeline/
│   ├── query/
│   └── index/
│
├── Persistence Layer
│   ├── serialization/
│   └── storage/
│
└── Public API
    ├── api/
    └── repository/

---

License

TBD