What's New in Version 1.17.0

June 25, 2026 8:27 PM UTC

Version 1.17.0 of the relationalai Python package is now available!

To upgrade, activate your virtual environment and run the following command:

pip install --upgrade relationalai

New Features and Enhancements

Added keyword field binding for Relationship calls. For example, if a relationship has src, transfer, and dst fields, you can write:
```
Account.transferred_to(src=source, transfer=transfer, dst=destination)
```
In addition to not having to pass fields in order, you also get clearer errors for missing fields and unknown fields.
Added support for per(...).product(...) to create a grouped product. Before 1.17.0, only product(...).per(...) was supported.
Combined more rai doctor report troubleshooting information into one zip file. Before 1.17.0, support cases could require both doctor_report_*.zip from rai doctor report and a separate oplog_report_*.zip from rai doctor report-oplog. Now rai doctor report includes that extra information in doctor_report_*.zip.

Fixed cases where duplicated values in prescriptive sum() and count() expressions inside a Problem were counted once in the aggregate instead of multiple times as expected.
Fixed Direct Access for Snowflake Private Link accounts.
Fixed handling for cross-model mix-ups when code uses objects from one Model inside another Model. Some of these cases previously resulted in empty results or confusing errors. PyRel now raises a clear, direct error instead.
Improved the error shown when top(), bottom(), or limit() is used in places that require a single value, such as comparisons or property values.