Issue Link / Problem Description

• No existing issue tracked this; found while reading the integrations package.

src/ragas/integrations/griptape.py wraps from griptape.engines.rag import RagContext in a try/except whose message was copied verbatim from the Opik tracer, so a missing griptape install tells users to install the wrong package:

except ImportError:
    raise ImportError(
        "Opik is not installed. Please install it using `pip install opik` to use the Opik tracer."
    )

Reproduce with a plain install (no extras) and:

>>> import ragas.integrations.griptape
ImportError: Opik is not installed. Please install it using `pip install opik` to use the Opik tracer.

Changes Made

• src/ragas/integrations/griptape.py: the ImportError now names the package that is actually missing (pip install griptape) and chains the original error with from e, matching the guard style in src/ragas/integrations/ag_ui.py.
• tests/unit/integrations/test_griptape.py: regression test that simulates a missing griptape module and asserts the raised ImportError mentions griptape, not opik, and chains the original ImportError.

Testing

How to Test

• Automated tests added/updated
• Manual testing steps:
  1. uv run --active pytest tests/unit/integrations/test_griptape.py — passes (1 passed); fails on main with AssertionError: assert 'griptape' in 'opik is not installed. please install it using pip install opik to use the opik tracer.'
  2. uv run --active pytest tests/unit — 805 passed, 89 skipped; the 7 remaining failures (test_tracing.py::TestLangfuseIntegration ×2, test_experiment.py::TestVersionExperiment ×5) also fail on unpatched main and are unrelated to this change
  3. uv run --active ruff check src tests docs --exclude src/ragas/_version.py --config pyproject.toml — All checks passed!
  4. uv run --active ruff format --check src/ragas/integrations/griptape.py tests/unit/integrations/test_griptape.py --config pyproject.toml — 2 files already formatted
  5. PYRIGHT_PYTHON_FORCE_VERSION=latest uv run --active pyright -p pyproject.toml src/ragas/integrations/griptape.py — 0 errors, 0 warnings, 0 informations

References

• Related issues: none found
• Same guard pattern already used in src/ragas/integrations/ag_ui.py

Screenshots/Examples (if applicable)

Before:

ImportError: Opik is not installed. Please install it using `pip install opik` to use the Opik tracer.

After:

ImportError: Griptape is not installed. Please install it using `pip install griptape` to use the Griptape integration.