All notable changes to AuditAI are documented in this file.
- Guerrilla: LFS-safe clone (
git add -f, default branch detect, skip git-lfs filters) auditai compareregression gate for comparing current metric means with a saved baseline- Optional GitHub Action
baseline/max-dropinputs; comparison is appended to the PR report auditai baselinecreates a privacy-safe baseline from a passing report
- README install leads with
pip install auditai-cli
Published on PyPI as auditai-cli==0.1.1 (2026-07-17).
Bare name auditai is rejected by PyPI as too similar to existing audit-ai.
Import package and console script remain auditai.
- Judge token usage in run reports:
judge_usage.prompt_tokens/completion_tokens/total_tokens(API-reported for OpenAI/xAI; estimated for mock) - Terminal + Markdown report lines for tokens; cloud payload includes
judge_usage - Guerrilla prep: README noise filter (badges/URLs), mock adapter returns empty contexts,
--workflow-example-only, defaultjudge: mock fill_pr_body.py: token/judge placeholders + auto mock-judge disclaimer- Model-not-found hint on xAI/OpenAI judge errors
- xAI / Grok judge (
judge.provider: xai) — BYOK viaXAI_API_KEY, base URLhttps://api.x.ai/v1 - OpenAI-compatible overrides on judge:
base_url,api_key_env(proxies / OpenRouter-style gateways) - Example:
examples/xai_judge/auditai.yml
- Default xAI model →
grok-4.3(override in YAML;grok-3-ministill valid when set explicitly) OpenAIJudgeis the shared OpenAI-compatible client for bothopenaiandxai- Package version
0.1.1
pip install auditai
# fallback:
pip install "git+https://github.com/iZenDeveloper/auditai.git@v0.1.1"First public open-core release.
- CLI (
auditai):run,validate,init,report --pdf - YAML config v0.1 (
auditai.yml), dataset JSON/JSONL/CSV - Metrics: Faithfulness, Answer Relevancy, Prompt Injection
- BYOK OpenAI judge + offline
mockjudge; optional DeepEval backend - Reports: terminal table, Markdown (PR-ready), JSON (
schema_version: 0.1) - CI exit codes:
0pass ·1audit fail ·2config ·3internal - GitHub composite Action: gate PRs, upsert report comment, upload artifacts
- Cloud API stub (FastAPI/SQLite): projects, run ingest, list/detail, compliance PDF
- Next.js dashboard: project key login, sparklines, run history, PDF download
- Compliance PDF certificate (technical evidence + legal disclaimer)
- Examples:
rag_demo(mock server + intentional hallucination), GitHub/GitLab CI samples
pip install "git+https://github.com/iZenDeveloper/auditai.git@v0.1.0"
pip install "auditai[pdf] @ git+https://github.com/iZenDeveloper/auditai.git@v0.1.0"- uses: iZenDeveloper/auditai@v0.1
env:
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}