Skip to content

Commit fb162d2

Browse files
committed
docs(demo): add asciicast recording + GIF, embed in README
Adds a real recording of `aicertify demo` running end-to-end: - `docs/demo.cast` — asciinema v2 cast (60 KB, 135 frames). Replayable with `asciinema play docs/demo.cast` for byte-exact byte-stream reproduction. Recorded against the rich-UX runner from the preceding commit, with OPENAI_API_KEY unset, so it shows what a fresh-install user actually experiences. - `docs/demo.gif` — agg-rendered GIF (316 KB, 68 frames at 2× speed, monokai theme). Embedded in README right after the Quick Start so README visitors see the rich UX before they install anything: ASCII banner, spinners with emojis, MessageGroup panel, success markers, and the final report path. Renders inline in any markdown viewer including GitHub mobile. CHANGELOG records both this artifact set and the rich-UX rewrite from the preceding commit under [Unreleased].
1 parent fa7bf8b commit fb162d2

4 files changed

Lines changed: 149 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
### Changed
11+
12+
- **`aicertify demo` rewritten for the canonical rich-UX flow.** The previous demo runner produced plain `print()` output; it now mirrors [`examples/quickstart.py`](examples/quickstart.py) exactly — uses the high-level `application.create()` + `app.evaluate()` API and wraps each step in `print_banner`, `spinner`, `MessageGroup`, and `success` markers from `aicertify.utils.logging_config`. Visually identical to the canonical SDK experience.
13+
- **CLI default verbosity now WARNING, not INFO.** `aicertify demo` and `aicertify evaluate` no longer flood the terminal with INFO-level chatter from `langfair`, `deepeval`, the OPA policy loader, etc. Pass `--verbose` to opt back in (raises root logger to INFO and `aicertify` namespace to DEBUG).
14+
- **OPA `policy_loader` no longer warns on `helper_functions/`** — those `.rego` files are shared library code (reporting helpers, validation helpers), not policies, and were always meant to be skipped silently. Same for dot-prefixed config directories.
15+
16+
### Added
17+
18+
- **`docs/demo.cast` + `docs/demo.gif`** — asciinema recording of `aicertify demo` running end-to-end, embedded near the top of the README so visitors see the rich UX before installing anything.
19+
1020
## [0.7.1] — 2026-05-14
1121

1222
### Added

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,10 @@ aicertify demo
7070

7171
`aicertify demo` loads a bundled sample contract, evaluates it against the EU AI Act policy set via OPA, and writes `aicertify_demo_report.md` to the current directory. Open the report — that's what your audit deliverable looks like.
7272

73+
<p align="center">
74+
<img src="docs/demo.gif" alt="aicertify demo recording — banner, spinners, evaluation progress, generated report path" width="85%" />
75+
</p>
76+
7377
For richer evaluations (LangFair fairness metrics, DeepEval content-safety scoring, PDF reports), see [`examples/quickstart.py`](examples/quickstart.py) and the [forkable example bots](examples/) — each ships an `input_contract.json`, a `policy_config.yaml`, and a `run.py`.
7478

7579
### For development

0 commit comments

Comments
 (0)