evgraph-cli

The evgraph command-line tool for Evgraph.

What is it

evgraph-cli gives shell scripts, CI pipelines, and pre-commit hooks the same governance scan the evgraph Python API exposes, without writing any Python. It is intentionally a thin wrapper: this package contains no logic of its own beyond argument parsing and output-format selection — scanning and reporting are entirely delegated to evgraph.scan() / evgraph.scan_dataset_manifest() / Report, so the CLI and the library can never drift in behavior.

Main features

• evgraph scan MODEL_CARD APPROVAL DEPLOYMENT — runs the Model Card adapter across the three linked artifacts and prints a Report.
• evgraph scan-dataset-manifest MANIFEST — runs the dataset-manifest adapter over a CSV file and prints a Report.
• --format {json,markdown,sarif,oscal} — selects how the report is rendered (default json); sarif for CI annotations, markdown for a human-readable review, oscal for compliance tooling.
• Exit code 0 on a completed scan (findings are printed, not turned into a pass/fail exit status — Evgraph reports what the evidence shows, it does not gate a pipeline on your behalf).

Where to get it

The source is hosted on GitHub at: https://github.com/SVamseekar/evgraph

Binary installers for the latest released version are available at the Python Package Index (PyPI):

pip install evgraph-cli

From source, for contributing:

git clone https://github.com/SVamseekar/evgraph.git
cd evgraph
pip install -e reference/python/evgraph-core
pip install -e reference/python/evgraph-rules
pip install -e reference/python/evgraph
pip install -e reference/python/evgraph-cli

Dependencies

• evgraph — installed automatically as a dependency, which in turn pulls in evgraph-core and evgraph-rules.

pytest>=7 is required for the test suite (pip install "evgraph-cli[test]").

Quickstart

evgraph scan model_card.json approval.json deployment.json --format markdown
evgraph scan-dataset-manifest dataset_manifest.csv --format json

In a CI pipeline, emitting SARIF lets findings show up as inline annotations in tools that already consume that format:

evgraph scan model_card.json approval.json deployment.json --format sarif > evgraph.sarif

Documentation

Getting help

Ask questions and report bugs via GitHub Issues on the main repository.

Contributing

All contributions, bug reports, and feature requests are welcome on the main repository. See CONTRIBUTING.md and the Code of Conduct. Security reports: SECURITY.md.

License

BSD 3-Clause.