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.3.0.tar.gz (8.5 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.3.0-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mawlaia_evalforge-0.3.0.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mawlaia_evalforge-0.3.0.tar.gz
Algorithm Hash digest
SHA256 f4fba5b50cd5f6af6c08b861f69cfb80d88b9e643bd2d2712ed666f6589cc306
MD5 68ea8ca9cdef9e9773fc6f9dc6905bab
BLAKE2b-256 34de949fc5c962f39d32e4eee0b559af54b36434bea0cf25267a7a78e1738bcd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mawlaia_evalforge-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 beb5162a3ea1237fbd6404739c9509e0ad8b47fa1ab7927a7dd643cbb10dd25f
MD5 09347e084503ae26b986b4ce9720464e
BLAKE2b-256 4f5c52598b6a9f5d01a0c64b6419f778c8359097642480309e3084657119d461

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