cloud-diff 0.1.0

A diff tool for checking the Yaml, Json files while developing cloud based applications

cloud-diff

yaml-json-diff - YAML & JSON Diff Tool with AI Explanations

yaml-json-diff is a Python CLI tool and library based on DeepDiff for computing the difference between YAML and JSON files. It also offers optional AI-powered explanations of the diffs using local language models via Ollama.

---

Features

• Compare two .yaml, .yml, or .json files
• Human-readable or JSON-formatted diff outputs
• Optional AI-generated summary of changes (--explain) using LLMs like Mistral, LLaMA via Ollama
• Clean CLI interface via Typer
• Docker support

---

Installation

From PyPI

pip install yaml-json-diff

From GitHub (latest)

pip install git+https://github.com/pooya-rostami/yaml-json-diff.git

Poetry (local dev)

git clone https://github.com/pooya-rostami/yaml-json-diff.git
cd yaml-json-diff
poetry install --only main

---

Usage

CLI

yaml-json-diff FILE1 FILE2 [OPTIONS]

Options:

Option	Description
--explain, -e	Generate an AI explanation of the diff using a local LLM (via Ollama)
--model, -m	Model to use for explanation (default: mistral)

---

Examples

Basic diff:

yaml-json-diff config-v1.yaml config-v2.json

With AI Explanation:

yaml-json-diff config-old.json config-new.json --explain

Using a Custom Ollama Model:

yaml-json-diff file1.yaml file2.yaml --explain --model llama3

---

AI Support via Ollama

To use the --explain feature:

1. Install Ollama from https://ollama.com

2. Ensure Ollama is running:

ollama run mistral

3. Use the --explain flag in the CLI

By default, the tool uses the mistral model. You can switch to another model like llama3, codellama, etc.

---

Contributions

Contributions are very welcome! Feel free to report bugs or suggest new features using GitHub issues and/or pull requests.

---

License

This tool is distributed under GNU Lesser General Public License v3.