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.4.tar.gz (8.8 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.4-py3-none-any.whl (13.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mawlaia_evalforge-0.4.4.tar.gz
  • Upload date:
  • Size: 8.8 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.4.tar.gz
Algorithm Hash digest
SHA256 1a208260515593cc9d3d6eeba35433a936050629ae8254b90d37ebae10d36a74
MD5 242351a54e28c1499dc650b2cbab0828
BLAKE2b-256 e4528165ad1bf3a171041d302d7b3de06ade0efcc8156d9006c784e9f4a3af91

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mawlaia_evalforge-0.4.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 6433adbfd28ee7038ed6a9d0dd41431cba4527176c5b156378673e1488f90c22
MD5 f37ccbb7c5e2ef4167d85b4c4ab8c550
BLAKE2b-256 2e0d6f0abec22a113e99041839d5918100532d3c8b279d30ff60d4a38730bf55

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