Skip to content

Release Notes

1.26.1

Python SDK


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

  • Your first rai models deploy on a new branch now works without a manual rai models pull first. rai models switch pulls the branch for you. A bare rai models pull also now defaults --path to the model.path in your raiconfig.yaml.

  • Tearing down a parent branch now removes its child branches too, instead of leaving them orphaned and unable to pull or merge. As a safeguard, rai models teardown --allow-children stops when a child has unmerged changes until you also pass --allow-unmerged. rai models list and rai doctor report now flag any branches orphaned by an earlier teardown.

  • The rai models commands now recognize when the schema you name is already your active model branch, instead of acting as if it changed. rai models switch no longer prints a false "Switched" message, rai models branch tells you to pick a different name instead of erroring, and rai models list marks your active schema with a *.

Bug Fixes

  • Fixed a bug that caused queries using union() to run slowly and, in some cases, hang indefinitely.

  • Fixed a bug that could cause aggregates grouped with per() to evaluate incorrectly when used solely as a filter and not selected in the query results.

Fixed a bug that caused aggregates grouped by an entity with a composite key to evaluate incorrectly.

  • Fixed an issue that could cause an "invalid identifier" error when deploying a model.

  • Fixed a bug that could case an "Object does not exist" error when deploying a model to a case-sensitive schema name.

  • Fixed a bug where a deploy could fail when a Snowflake view or dynamic table (an auto-refreshing Snowflake table) was created before another object it reads from.

  • Fixed a bug where deploying an unedited rai models init project could fail immediately with a "Symbol ... is already registered" error.

  • Fixed a bug that could cause redeploying a model without any changes could fail.

  • Fixed an issue that prevented model re-deploys from picking up changes to a data sources Snowflake object.

  • Fixed a model deployment bug that ignored a user-supplied Snowpark session passed to create_config(), which is supposed to override any auto-detected Snowpark session.

  • Fixed a bug that could cause rai models pull or rai models merge to generate a runnable shared_model.py file. If you encountered this bug, pull or merge again to regenerate a corrected shared_model.py.

1.26.0

Python SDK


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

  • You can now deploy a model from Python with model.deploy() as a programmatic alternative to the CLI. It relies on the operation log, which is off by default, so set oplog.enabled to true to turn it on.

  • If you run PyRel inside Snowpark Container Services (SPCS) and connect via OAuth, use the new host option in your Snowflake connection configuration to the container's SNOWFLAKE_HOST endpoint. OAuth tokens in your configuration are validated against this host.

  • You can now cap how long PyRel waits for a reasoner to become ready or a query to finish by setting data.poll_timeout_mins in your raiconfig to a number of minutes so it raises a clear timeout error instead of hanging forever. It is off by default and only stops your Python client, not any work already running in Snowflake.

  • If your Snowflake account cannot use hybrid tables, such as a Tri-Secret Secure account, you can now set oplog.table_type: standard in your raiconfig to provision the operation log as a standard table instead of the hybrid default. Note that changing this setting after your first deployment does not update the existing oplog table. You'll need to delete the table and re-deploy in order for it to take effect.

  • The product() aggregation function, which multiplies values together, is now supported in deployed models.

  • The rai debugger has a new Refresh Log view that shows a deployed model's install plan and refresh history as a diagram, so you can watch a refresh as it runs. You can also start it with --no-show to skip opening a browser window when you restart it.

  • PyRel now catches a conflicting implicit_properties setting when you deploy, branch, merge, or pull with the operation log enabled, raising ModelConfigMismatchError when your current setting differs from the one recorded at the model's deploy, instead of letting the conflict break the model later. This setting (part of ModelConfig) controls whether using an undeclared property creates it or raises an error. To resolve the error, match the recorded setting or pass --force to override and record the new one.

  • Improved performance for refreshing a deployed model.

  • Improved generated output table name in deployed models. For example, tables with generated names like Number_38_0_datapoints will now be saved as simply datapoints. If downstream queries or dashboards referenced the old name, update them after you redeploy.

  • Improved the error message you get when a deploy can't start because another is already in progress.

Bug Fixes

  • Fixed a model deployment bug where a model that used Model.Enum() failed to deploy with the errorValueError: No SQL type for column 'x'.

  • Fixed a bug where ranking or limiting rows over a concept with a composite key in a query or definition would fail with an invalid identifier error.

  • PyRel now internally sorts entities with composite keys differently than it used to. You may see results for queries that involve rank() or top() return rows where the rank is tied in a slightly different order.

  • Fixed a model deployment bug where calling re.findall() or strings.split() on a Table column produced extra rows in the output table.

  • Fixed a bug where a query computed two count(...).per(key) values over the same text key, one for values in a list and one for values not in it. The in-list count silently returned NULL on every row. Both counts now return the correct number.

  • Fixed a bug that caused some aggregations over properties that are set for some entities but not others to include values from entities that should have been excluded.

  • Fixed a model deployment issue that caused some models to fail with aSQL object_name collision error when deployed.

  • Fixed a bug where an unresolved chained reference in a query (a multi-step property or relationship lookup that was never given a value) could silently produce incorrect query results. PyRel now raises an error.

  • Fixed a bug in the prescriptive reasoner where a count or a summed objective (a total or a tally aggregated over rows) could silently drop rows that shared a value, so the solver optimized the wrong total. For example, with costs of 5, 5, and 7, the two 5s collapsed into one, giving 12*x instead of 17*x. Each row now contributes its own term.

  • The prescriptive reasoner now rejects a non-numeric value, such as a text or date property, used where a number is expected, with a clear error when you build the problem. Before, the problem built successfully and failed only during the solve, with a confusing internal error.

  • Fixed several problems with tearing down a deployed model using rai models teardown. Leftover local state could be wrongly reused on a later redeploy, and a partial teardown could not be completed by re-running it. Teardown now cleans up reliably and can be safely re-run after a partial failure.

  • Fixed a bug where rai models teardown and rai models merge could act on a malformed schema. Both commands now always reject a malformed or ambiguous schema name with a clear error.

2026.8.3-49c7820

Native App


Version 2026.8.3-49c7820 of the RelationalAI Native App is now available!

Note that RelationalAI Native App upgrades are applied automatically and require no action on your part, unless you have opted-in to manual upgrades.

New Features and Enhancements

Bug Fixes

  • Fixed an issue that caused data streams to be quarantined during brief pauses in the CDC service.

  • Fixed an issue that could stop a data stream from syncing when the app's routine cleanup removed part of the internal data store that the CDC service uses to load your data.

  • Prevented the app from leaving Snowflake compute resources running indefinitely when an internal engine fails to start.

1.25.0

Python SDK


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

  • You can now tear down a deployed model from Python with model.teardown(), which is the cleanup counterpart to model.deploy(), so you can remove a model you no longer need without leaving your script or notebook.

    Called with no arguments, model.teardown() only shows what it would remove and deletes nothing. When you pass force=True, the call actually performs the teardown. This drops the model's deployed schema in Snowflake, along with its meta schema and operation log, which is the same thing the rai models teardown CLI command does:

    model.teardown()            # preview: lists what would be dropped, drops nothing
    model.teardown(force=True)  # drop the deployed model for real
    

    Teardown cannot be undone, so check the preview before you use force=True. Your local model files, including the generated shared_model.py, are left in place.

  • Running rai doctor report now shows which shared_model.py file it used, as a new "Shared model file" entry in the report summary. This lets you confirm PyRel picked up the file you expected, which matters when a stray copy in a parent directory could otherwise be used without you noticing.

Bug Fixes

  • Fixed a bug where a query that placed a union(...) next to another filter in the same where(...) could return incorrect results.

    For example, the status == "open" filter below was ignored for one region, so results could include orders that were not open. The filter now applies to both branches of the union:

    where(
        Order.status == "open",
        union(Order.region == "US", Order.region == "EU"),
    ).select(Order.id).to_df()
    
  • Fixed a bug that could cause an "invalid identifier" error when you deployed a model to Snowflake.

  • Fixed a bug that could crash Snowflake's SQL compiler with an out-of-memory error when deploying a model.

  • Fixed a bug that caused a Snowflake "invalid regular expression" or "named groups not supported" error when calling re.sub, re.search, or re.match on certain patterns, such as re.sub(r"\D", "", text).

  • Reading table rows into a concept no longer exposes the internal __row_id_* fields it uses to tell identical rows apart. They previously appeared as public properties when you inspected your model, and are now kept internal.

  • When rai models deploy fails, you now see a short, readable error message instead of a long Python traceback. It also exits with a nonzero exit code, so scripts and CI pipelines can detect the failure and stop instead of continuing as if the deploy worked. This also applies to --wait, which is the option that keeps the command running until the deploy finishes.

  • The first deploy of a large model no longer fails with an OplogAppendTooLargeError, which used to stop the deploy with no way around it when it needed to write more than about 900 KB at once to the model's operation log. The operation log is the running record of changes PyRel keeps for a deployed model. The deploy now completes with no change to your model.

  • A model no longer fails to deploy with an [Unground Variable] error when a concept is identified by both a reference to another concept and a plain-value field from the same source table, for example a LineItem identified by its Order and a line number.

  • Running rai models pull more than once on a shared live branch, one that several people deploy to and pull from, now gives consistent results. Before, a second pull could quietly change the model definition you ended up with, so collaborators could drift out of sync. To get the fix, upgrade every collaborator to 1.25.0 before anyone runs the first pull, because afterward an older version of PyRel can no longer write to that branch.

  • In the rai debugger, you can now expand a compiler pass for one block of a deployed model without the same pass opening in every other block, so the view stays focused on the block you are inspecting.

2026.7.27-74739c9

Native App


Version 2026.7.27-74739c9 of the RelationalAI Native App is now available!

Note that RelationalAI Native App upgrades are applied automatically and require no action on your part, unless you have opted-in to manual upgrades.

Bug Fixes

  • Exporting query results no longer fails when one of the exported columns has the same value in every row. Previously, these exports failed the entire transaction with an internal error.

  • A query that reads from a Snowflake source through a data stream no longer fails if that stream is being deleted and rebuilt while the query runs. Data streams keep your PyRel models in sync with their Snowflake sources, and PyRel sometimes rebuilds one to refresh it. Previously, a query caught in that window failed with a The provided data streams do not exist (RAIERR:1000) error, even though the stream was being replaced, not removed. Now the query finishes once PyRel rebuilds the stream.