snapdelta 0.3.0

Snapshot your devices and services, then see exactly what changed.

Take a snapshot of anything, then compare two snapshots. A plugin brings the diffsync models and a source: the way to get the data of one target, from input files, an API, NETCONF or SSH. snapdelta saves each load as a snapshot, compares two snapshots on their models, not on text, and shows what changed.

snapdelta is a plug-in architecture: the sources, the stores, the formats, the inventories, the secret backends, the notifiers, the compare rules and the runners are plugins, the built-in ones included. snapdelta plugins new NAME writes a plugin package that works, snapdelta doctor checks it, and snapdelta.testing gives it contract tests.

This package is the core and the snapdelta CLI. The web UI, the JSON API and the MCP server are in snapdelta-web.

Install

snapdelta needs Python 3.13 or later. In your plugin project:

uv add snapdelta

Use it

With a plugin source installed (here my-source):

snapdelta snapshot --source my-source --all-targets --label before
snapdelta snapshot --source my-source --all-targets --label after
snapdelta diff R1@before R1@after

Documentation

• Getting started: your own project, step by step
• Architecture: the parts and the extension points
• Plugins: each extension point, write and check a plugin
• Profiles: ignore, rules, tolerance, counts, pairs
• Inventory: the optional Nornir inventory
• Settings: every key of snapdelta.toml
• Changelog

License

Apache License 2.0.