Python package and CLI 1.17.0

Jun 25, 2026, 8:27 PM UTC

PyRel 1.17.0 adds relationship keyword arguments, supports per(...).product(...), and fixes several bugs.

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.17.0"

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

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.