Python package and CLI 1.9.0

Jun 4, 2026, 11:12 PM UTC

Concept.filter_by() and Ref.filter_by() still work in PyRel 1.9.0 but now emit deprecation warnings, so switch to .lookup() when updating your code.

How to install this version

Review the changes below before installing. To install this version, activate a compatible Python virtual environment and run:

python -m pip install "relationalai==1.9.0"

For the latest installation instructions, see Start building with PyRel.

Upgrade Notes

• If your code uses filter_by() on Concept or Ref, it now emits a Python DeprecationWarning in 1.9.0. Your existing code still works in 1.9.0. Use .lookup() instead of filter_by() going forward.

New Features and Enhancements

• Prescriptive solve() now helps you inspect solved models and diagnose infeasible ones. Use solve(sensitivity=True) after solving to inspect solve diagnostics such as reduced costs and constraint sensitivity. Use solve(conflict=True) to identify infeasibility conflicts, then check solve_info().conflict_status.

• PyRel 1.9.0 improves CLI diagnostics. rai doctor now prints live health checks, and doctor:report collects diagnostic artifacts for support.

Bug Fixes

• Fixed a bug where queries using top(), bottom(), or limit() could fail with a SQL parser error.

• When raiconfig.yaml contains placeholders, rai doctor now identifies the missing configuration instead of failing with a raw connection error.

• If you use grouped optional aggregates over stored relationships, those Snowflake-backed queries now run correctly. Before this fix, they could fail with Unsupported subquery type cannot be evaluated.