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.0.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.0-py3-none-any.whl (13.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mawlaia_evalforge-0.4.0.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.0.tar.gz
Algorithm Hash digest
SHA256 7617b332642690926702d5798d1c552095b3e419591da98607c74d9ad8f098b0
MD5 298d52bf6175f9206a96944953bd2e46
BLAKE2b-256 fec735004e7f5afcf0befe4dd71d7419714fd9a270d473e9f56633e4d4485114

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mawlaia_evalforge-0.4.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e87ecfece2a921b072a7b4e0fe8d9eeb7f0005cb1261b1f8ac5092450b7432a3
MD5 95d4eae6680c11f3e56ad837bb5de871
BLAKE2b-256 2f320ff4f3b6c16d4838046939cf15bbb300c8cf05b372eef1d51809d18abb06

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