NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #3960 most downloaded on PyPI
Evaluation framework for RAG and LLM applications
Last release 8 months ago
13 Jan 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
3 years old
88 releases · first in 2023
One column per quarter.
feat: add DSPyOptimizer with MIPROv2 for advanced prompt optimization by @anistark in #2537
DSPyOptimizer with MIPROv2 for advanced prompt optimization by @anistark in #2537InstructorLLM and LiteLLMStructuredLLM by @anistark in #2543DiskCacheBackend pickling issue with InstructorLLM by @anistark in #2556Full Changelog: v0.4.2...v0.4.3
feat: add support for new google-genai SDK with backwards compatibility for deprecated google-generativeai by @anistark in #2517
Full Changelog: v0.4.1...v0.4.2
feat: add save/load methods to BasePrompt by @anistark in #2465
ToolCallAccuracy to collections API by @anistark in #2476Full Changelog: v0.4.0...v0.4.1
docs: complete collections API documentation for remaining metrics by @sanjeed5 in #2420
temperature and top_p constraint handling by @anistark in #2418Full Changelog: v0.3.9...v0.4.0
chore: remove deprecated ground_truths by @anistark in #2402
ground_truths by @anistark in #2402max_completeion_tokens error for newer openai models by @anistark in #2413Full Changelog: v0.3.8...v0.3.9
fix: add missing metrics (ToolCallF1, ChrfScore) to sidebar and document deprecated ContextUtilization by @anistark in #2381
instructor_llm_factory merge with llm_factory by @anistark in #2382Full Changelog: v0.3.7...v0.3.8
refactor: improve metrics code quality by @anistark in #2337
Full Changelog: v0.3.6...v0.3.7
Deprecation warnings for LLMs and Prompts by @rhlbhatnagar in #2253
Full Changelog: v0.3.5...v0.3.6
Docs/howto-texttosqlagent by @sanjeed5 in #2264
ragas-examples by @jjmachan in #2289Full Changelog: v0.3.4...v0.3.5
v0.3.5rc2 Pre-release Pre-release Compare # Choose a tag to compare
v0.3.5rc2 Pre-release
Pre-release
Compare
Docs/howto-texttosqlagent by @sanjeed5 in https://github.com/explodinggradients/ragas/pull/2264
ragas-examples by @jjmachan in https://github.com/explodinggradients/ragas/pull/2289Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.4...v0.3.5rc1
Update context_precision.md by @anupamck in https://github.com/explodinggradients/ragas/pull/2262
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.3...v0.3.4
security: stop supporting v0.2 security releases by @anistark in https://github.com/explodinggradients/ragas/pull/2230
embeddings to maintain backward compatibility by @NirantK in https://github.com/explodinggradients/ragas/pull/2184tracing from experimental to ragas/integrations by @NirantK in https://github.com/explodinggradients/ragas/pull/2188prompts to ragas by @NirantK in https://github.com/explodinggradients/ragas/pull/2197/claude-review command by @jjmachan in https://github.com/explodinggradients/ragas/pull/2214docs/getstarted/evals.md by @sadra-barikbin in https://github.com/explodinggradients/ragas/pull/2081py.typed marker file to support type checking by @sisp in https://github.com/explodinggradients/ragas/pull/2029ragas.experimental namespace by @NirantK in https://github.com/explodinggradients/ragas/pull/2223Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.2...v0.3.3
security: stop supporting v0.2 security releases by @anistark in https://github.com/explodinggradients/ragas/pull/2230
embeddings to maintain backward compatibility by @NirantK in https://github.com/explodinggradients/ragas/pull/2184tracing from experimental to ragas/integrations by @NirantK in https://github.com/explodinggradients/ragas/pull/2188prompts to ragas by @NirantK in https://github.com/explodinggradients/ragas/pull/2197/claude-review command by @jjmachan in https://github.com/explodinggradients/ragas/pull/2214docs/getstarted/evals.md by @sadra-barikbin in https://github.com/explodinggradients/ragas/pull/2081py.typed marker file to support type checking by @sisp in https://github.com/explodinggradients/ragas/pull/2029ragas.experimental namespace by @NirantK in https://github.com/explodinggradients/ragas/pull/2223Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.2...v0.3.3rc1
feat: save and load prompt object by @jjmachan in https://github.com/explodinggradients/ragas/pull/2152
AnswerSimilarity a dataclass by @hutec in https://github.com/explodinggradients/ragas/pull/2159backend to ragas main by @NirantK in https://github.com/explodinggradients/ragas/pull/2174experiment from experimental to ragas main by @NirantK in https://github.com/explodinggradients/ragas/pull/2175Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.1...v0.3.2
Nothing published for this version
fix: pypi requirements and image absolute path by @anistark in https://github.com/explodinggradients/ragas/pull/2196
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.2-rc1...v0.3.2-rc2
feat: save and load prompt object by @jjmachan in https://github.com/explodinggradients/ragas/pull/2152
AnswerSimilarity a dataclass by @hutec in https://github.com/explodinggradients/ragas/pull/2159backend to ragas main by @NirantK in https://github.com/explodinggradients/ragas/pull/2174experiment from experimental to ragas main by @NirantK in https://github.com/explodinggradients/ragas/pull/2175Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.1...v0.3.2-rc1
docs: improve hello world by @shahules786 in https://github.com/explodinggradients/ragas/pull/2127
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.3.0...v0.3.1
CVE-2025-45691 Fix: Arbitrary File Read Vulnerability + Feat: Security settings by @adithyan-ak in https://github.com/explodinggradients/ragas/pull/19…
ragas_experimental back into main by @jjmachan in https://github.com/explodinggradients/ragas/pull/2031Project by @jjmachan in https://github.com/explodinggradients/ragas/pull/2106llm_factory and embedding_factory by @jjmachan in https://github.com/explodinggradients/ragas/pull/2112ragas.experimental and cleaned dependencies by @jjmachan in https://github.com/explodinggradients/ragas/pull/2119inmemory backend by @jjmachan in https://github.com/explodinggradients/ragas/pull/2116Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.15...v0.3.0
Nothing published for this version
md of vertexai notebooks by @sahusiddharth in https://github.com/explodinggradients/ragas/pull/1957
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.14...v0.2.15
feat: add http request-response logging with env flag control by @ganeshrvel in https://github.com/explodinggradients/ragas/pull/1903
StatementGeneratorPrompt in faithfulness by @sahusiddharth in https://github.com/explodinggradients/ragas/pull/1906cosine_similarity transform for docs with Token Count 101–500 by @rgrizzo-linksmt in https://github.com/explodinggradients/ragas/pull/1934Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.13...v0.2.14
Improved the documentation in the migration docs by @sahusiddharth in https://github.com/explodinggradients/ragas/pull/1873
timeout in RunConfig by @neo in https://github.com/explodinggradients/ragas/pull/1872Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.12...v0.2.13
Add token parser for Bedrock & fix anthropic typo by @michaelromagne in https://github.com/explodinggradients/ragas/pull/1851
evaluator_embeddings by @neo in https://github.com/explodinggradients/ragas/pull/1858Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.11...v0.2.12
fix: add min requirement for optimisation by @shahules786 in https://github.com/explodinggradients/ragas/pull/1820
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.10...v0.2.11
docs: new get started guide by @shahules786 in https://github.com/explodinggradients/ragas/pull/1786
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.9...v0.2.10
feat: replaced NLTK's implementation of BLEU with sacrebleu's implementation by @trent-sp in https://github.com/explodinggradients/ragas/pull/1744
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.8...v0.2.9
fix: Update README.md by @avanco in https://github.com/explodinggradients/ragas/pull/1738
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.7...v0.2.8
feat: removed critics and rubrics from examples by @jjmachan in https://github.com/explodinggradients/ragas/pull/1691
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.6...v0.2.7
Avoid unnecessary decompose_claims call when mode='precision' in _factual_correctness.py by @dfhssilva in https://github.com/explodinggradients/ragas/
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.5...v0.2.6
feat: Unify the use of sentence_segmenter by @jasinliu in https://github.com/explodinggradients/ragas/pull/1629
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.4...v0.2.5
Fix : Filename in the path by @satodayo in https://github.com/explodinggradients/ragas/pull/1605
EvaluationResult by @jjmachan in https://github.com/explodinggradients/ragas/pull/1625. as a split condition in noise_sensitivity.py by @jasinliu in https://github.com/explodinggradients/ragas/pull/1627Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.3...v0.2.4
feat: measure cost of testset generator by @jjmachan in https://github.com/explodinggradients/ragas/pull/1560
reference_topics as default required columns in TopicAdherenceScore #1564 by @luqmansen in https://github.com/explodinggradients/ragas/pull/1566Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.2...v0.2.3
docs: update summarization calculation by @jCobbSK in https://github.com/explodinggradients/ragas/pull/1510
EvaluationResult by @jjmachan in https://github.com/explodinggradients/ragas/pull/1531Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.1...v0.2.2
Fix Discord link by @NirantK in https://github.com/explodinggradients/ragas/pull/1498
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.2.0...v0.2.1
feat: topic adherence metric by @shahules786 in https://github.com/explodinggradients/ragas/pull/1327
TestsetGenerator by @jjmachan in https://github.com/explodinggradients/ragas/pull/1375experimental.testset to replace old testset by @jjmachan in https://github.com/explodinggradients/ragas/pull/1401Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.20...v0.2.0
feat: topic adherence metric by @shahules786 in https://github.com/explodinggradients/ragas/pull/1327
TestsetGenerator by @jjmachan in https://github.com/explodinggradients/ragas/pull/1375experimental.testset to replace old testset by @jjmachan in https://github.com/explodinggradients/ragas/pull/1401Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.20...v0.2.0-beta
Nothing published for this version
based on v0.1.16 which was the last working version for 0.1
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.16...v0.1.21
fix: pin langchain_core to <3 by @jjmachan in https://github.com/explodinggradients/ragas/pull/1329
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.19...v0.1.20
feat: add non llm based context recall by @shahules786 in https://github.com/explodinggradients/ragas/pull/1266
evaluate by @freddiev4 in https://github.com/explodinggradients/ragas/pull/1279Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.18...v0.1.19
fix: inverse distance by @shahules786 in https://github.com/explodinggradients/ragas/pull/1267
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.17...v0.1.18
update documentation for faithfulness with HHEM by @Miaoranmmm in https://github.com/explodinggradients/ragas/pull/1242
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.16...v0.1.17
load HHEM on specified device by @Miaoranmmm in https://github.com/explodinggradients/ragas/pull/1235
ragas.experimental by @jjmachan in https://github.com/explodinggradients/ragas/pull/1240Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.15...v0.1.16
fix: typo in model name by @shahules786 in https://github.com/explodinggradients/ragas/pull/1198
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.14...v0.1.15
Add question to context recall doc by @shahules786 in https://github.com/explodinggradients/ragas/pull/1173
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.13...v0.1.14
Fix "global flags not at the start" raised in extract_text function by @vaishakhRaveendran in https://github.com/explodinggradients/ragas/pull/1113
adapt function to translate cached prompts in place. by @HerrIvan in https://github.com/explodinggradients/ragas/pull/889RunConfig documentation and improvements by @jjmachan in https://github.com/explodinggradients/ragas/pull/1159ragas.run_config.RunConfig rng attribute. by @Gwenn-LR in https://github.com/explodinggradients/ragas/pull/1169track_completed decorator to track completed functions by @jjmachan in https://github.com/explodinggradients/ragas/pull/1171Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.12...v0.1.13
[Fix bug] The adaptation for rewrite_invalid_question_prompt was not saved by @psydok in https://github.com/explodinggradients/ragas/pull/1071
rewrite_invalid_question_prompt was not saved by @psydok in https://github.com/explodinggradients/ragas/pull/1071Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.11...v0.1.12
Testgeneration v3 by @shahules786 in https://github.com/explodinggradients/ragas/pull/1024
experimental runnable by @jjmachan in https://github.com/explodinggradients/ragas/pull/1078is_async argument since everything is async now by @jjmachan in https://github.com/explodinggradients/ragas/pull/1116Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.10...v0.1.11
Update testset_generation.md - fix typo by @GTimothee in https://github.com/explodinggradients/ragas/pull/1008
get_available_metrics method by @immortal3 in https://github.com/explodinggradients/ragas/pull/1025Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.9...v0.1.10
Nothing published for this version
docs: langchain.document_loaders is deprecated by @bioerrorlog in https://github.com/explodinggradients/ragas/pull/881
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.7...v0.1.8
minor: fix llm expansion in docs by @glenacota in https://github.com/explodinggradients/ragas/pull/847
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.6...v0.1.7
Fix: json format inconsistency in context recall (prompt for statemen… by @jokokojote in https://github.com/explodinggradients/ragas/pull/776
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.5...v0.1.6
fix: handle string score in node filter by @shahules786 in https://github.com/explodinggradients/ragas/pull/755
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.4...v0.1.5
docs: Add docs for new entity based metric by @sky-2002 in https://github.com/explodinggradients/ragas/pull/674
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.3...v0.1.4
feat: improved node selection and question fixing by @shahules786 in https://github.com/explodinggradients/ragas/pull/644
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.2...v0.1.3
docs: arize/ ragas notebook by @axiomofjoy in https://github.com/explodinggradients/ragas/pull/594
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.1...v0.1.2
Fixing typos, vertextai to vertex ai by @mrchtr in https://github.com/explodinggradients/ragas/pull/572
Full Changelog: https://github.com/explodinggradients/ragas/compare/v0.1.0...v0.1.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →