Python package and CLI 1.21.4

Jul 18, 2026, 12:37 AM UTC

PyRel 1.21.4 fixes duplicated rows in some deployed models and speeds up refreshes for models with declared primary keys.

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

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

New Features and Enhancements

Deployed models now refresh more efficiently when a concept declares primary keys with identify_by. Before this release, PyRel always added a hashed _ID key column to deployed concept tables and joined on it. Now it uses the declared key columns directly, so each refresh does less work and returns the same results.

Fixed a correctness problem in deployed models where you identify a concept by a source column whose values can repeat, such as an Order identified by an order id that appears on many line-item rows. Before this release, that concept’s deployed table could contain duplicate rows for the same Order, so some queries over it could return wrong results. The table now keeps one row per entity, so those queries return correct results.
Fixed Model.Table] so that you can access Snowflake source columns whose names contain spaces. Before this release, accessing such a column by the name you declared (for example, orders["customer id"]) raised a KeyError even though the column existed. Now it resolves to that column.