●Change8

Migrating to RAGAS v0.3.3

Version v0.3.3 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.datasetragas.embeddingsResponseRelevancy_nv_metrics.pyRefusalRateInstructorLLM

Breaking Changes

●Issue #1

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

●Issue #2

The `dataset` module has been moved from an external location to the main `ragas` package. Imports referencing the old location must be updated.

Migration Steps

  1. 1
    Update any imports referencing the retired `ragas.experimental` namespace.
  2. 2
    Update imports for the `dataset` module to reflect its move to the main `ragas` package.
  3. 3
    Review usage of `embeddings` due to added deprecation warnings and refactoring.

Release Summary

This release focuses heavily on internal restructuring, moving modules like `tracing`, `prompts`, `dataset`, and experimental features into the main package structure while retiring the `ragas.experimental` namespace. Numerous bug fixes address CI, LLM compatibility (especially OpenAI O1 series), and metric stability.

Need More Details?

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

View Full Changelog