Skip to main content

Eval runner for LLM applications

Project description

evalforge

Eval runner for LLM applications. CI-native AI quality.

Your code has tests. Your prompts don't. evalforge brings the same quality gates you have for code to your LLM features — run on every PR, catch regressions before they reach production.

from evalforge import EvalDataset, run_eval
from evalforge.scorers import llm_judge, exact_match

dataset = EvalDataset.from_json("evals/rag_quality.json")

report = run_eval(
    dataset=dataset,
    model="claude-3-5-sonnet",
    scorers=[llm_judge(rubric="Is the answer accurate and grounded?"), exact_match()],
)

report.assert_pass(threshold=0.85)  # fails CI if score drops below 85%

Status

🚧 Early development. Star to follow progress.

What it does

  • Eval runner — LLM-as-judge, exact match, ROUGE, semantic similarity, custom Python scorers
  • CI integration — GitHub Actions native, fails the build if quality drops
  • Dataset versioning — store, version, and sample eval sets
  • Comparison mode — A/B test prompts and models against a baseline
  • Shadow traffic — route production traffic to a new model and compare live
  • Vertical eval packs — pre-built datasets and scorers for RAG, customer support, code generation, legal, medical

Roadmap

  • Python SDK
  • CLI
  • GitHub Actions action
  • Hosted control plane (mawlaia.com)
  • Vertical eval packs

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mawlaia_evalforge-0.4.2.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mawlaia_evalforge-0.4.2-py3-none-any.whl (13.0 kB view details)

Uploaded Python 3

File details

Details for the file mawlaia_evalforge-0.4.2.tar.gz.

File metadata

  • Download URL: mawlaia_evalforge-0.4.2.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.3 CPython/3.13.3 Darwin/25.3.0

File hashes

Hashes for mawlaia_evalforge-0.4.2.tar.gz
Algorithm Hash digest
SHA256 02d3668bac7afb7eecb7c19b63ec4add24df5e05efd51e144ae393491ce86e1e
MD5 e33d47fd1a0f198354102dea6415ccd8
BLAKE2b-256 9c6fec4551ce06bfccc372d9d54e5b30b06004a85af3af06af21d5ef688e6836

See more details on using hashes here.

File details

Details for the file mawlaia_evalforge-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: mawlaia_evalforge-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 13.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.3 CPython/3.13.3 Darwin/25.3.0

File hashes

Hashes for mawlaia_evalforge-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4e69b9071dbf1ed6d17f6af1dd32f60bb7f80822f08607debb06ae987e6f883b
MD5 383c4367622442816aa9bb8e28b7d411
BLAKE2b-256 00a62d3f9dac39f5800297c84abf556ccc9d944094a35de13545a6b24a2a7f97

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page