fabricatio-checkpoint 0.1.1.dev15

An extension of fabricatio

fabricatio-checkpoint

MIT

An extension of fabricatio.

---

📦 Installation

This package is part of the fabricatio monorepo and can be installed as an optional dependency:

pip install fabricatio[checkpoint]

# or with uv
# uv pip install fabricatio[checkpoint]

Or install fabricatio-checkpoint along with all other components of fabricatio:

pip install fabricatio[full]

# or with uv
# uv pip install fabricatio[full]

🔍 Overview

Provides version control and checkpointing capabilities for fabricatio workflows, allowing users to save, rollback, and manage states of their worktrees using a git-like shadow repository system. It enables seamless state management during complex AI-driven processes, supporting both individual file rollbacks and full worktree resets to maintain workflow consistency and enable experimentation.

🧩 Key Features

• Checkpoint Saving: Save current worktree state with custom messages to preserve progress at any point
• Selective Rollback: Rollback individual files to previous checkpoints without affecting other files
• Full Reset: Reset entire worktree to any saved checkpoint state for complete state restoration
• Diff Tracking: Retrieve file differences between checkpoints to understand changes over time
• Shadow Repository Management: Automatic handling of git-like shadow repositories with configurable caching
• Workflow Integration: Seamless integration with fabricatio agents for reliable state management in AI workflows

🔗 Dependencies

Core dependencies:

• fabricatio-core - Core interfaces and utilities

No additional dependencies required.

📄 License

This project is licensed under the MIT License.