●Change8

Migrating to RAGAS v0.3.3rc1

Version v0.3.3rc1 introduces 2 breaking changes. This guide details how to update your code.

Released: 9/4/2025

2
Breaking Changes
3
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

ragas.experimentalragas.embeddingsInstructorLLM_nv_metrics.pyRefusalRateResponseRelevancy_version.py

Breaking Changes

●Issue #1

The `ragas.experimental` namespace has been retired. Users must update imports from this namespace to the main package structure.

●Issue #2

The structure of `ragas.embeddings` has been refactored; while backward compatibility is maintained, users relying on internal structures might need review.

Migration Steps

  1. 1
    Update all imports that referenced modules or functions under `ragas.experimental` to their new locations in the main `ragas` package.
  2. 2
    Review usage of `ragas.embeddings` if internal structures were relied upon, due to refactoring.
  3. 3
    If using OpenAI O1 series models, ensure you are aware of the temperature setting change or explicitly set bypass temperature if needed.

Release Summary

This release focuses heavily on internal restructuring, migrating modules like `tracing`, `prompts`, `dataset`, and experimental metrics out of experimental namespaces and into the main package structure. It also includes numerous bug fixes, performance optimizations (like 50% speedup for factual correctness), and improved LLM compatibility.

Need More Details?

View the full release notes and all changes for RAGAS v0.3.3rc1.

View Full Changelog