Skip to content

Python API Release Notes

1.9.0

Python SDK


Version 1.9.0 of the relationalai Python package is now available!

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

pip install --upgrade relationalai

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.

1.8.1

Python SDK


Version 1.8.1 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

1.8.0

Python SDK


Version 1.8.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

  • A standard relationalai install now includes the packages needed for predictive reasoning workflows. You no longer need to install using pip install relationalai[gnn].

  • If a model contains multiple exports to Snowflake tables, independent exports are now run concurrently.

Bug Fix

  • Predictive GNN edge tables now load in a stable order. gnn.dataset.tables indices are now deterministic across runs.

1.7.1

Python SDK


Version 1.7.1 of the relationalai Python package is now available!

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

pip install --upgrade relationalai

Bug Fixes

  • Fixed a bug that prevented the creation of concepts with spaces and other special characters in their names.

  • Fixed a bug that caused some users to see the following error:

    Uncaught exception of type 'STATEMENT_ERROR' on line 88 at position 6 : Uncaught exception of type 'STATEMENT_ERROR' on line 46 at position 0 : SQL compilation error:
    Window function type [ROW_NUMBER] requires ORDER BY in window specification.
    

1.7.0

Python SDK


Version 1.7.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

  • Snowflake connections now support authenticator="oauth_client_credentials" for app-to-app OAuth flows. See OAuthClientCredentialsAuth for configuration details.
  • Added rai reasoners sizes to inspect available reasoner sizes.

Bug Fixes

  • PyRel now normalizes Snowflake object identifiers the same way that Snowflake does. This prevents errors that claim that existing objects can't be found.