Python package and CLI 1.2.2

May 7, 2026, 8:59 PM UTC

PyRel 1.2.2 adds more consistent CLI JSON and YAML output, new wait controls for long-running workflows, and Cortex agent deployment diagnostics.

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

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

New Features and Enhancements

• More RAI CLI commands now support JSON and YAML output options, and these output formats has been standardizes across commands for easier integration with automation scripts.

  The following commands now all support --output json and --output yaml:

  • rai commands
  • rai jobs events
  • rai reasoners list

• Added a new rai reasoners wait command that blocks until a reasoner is READY. In addition, the rai reasoners create and rai reasoners resume commands now support --wait and --no-wait options.

• Cortex agent deployment diagnostics now help you validate your Snowflake setup before deployment:

  • Use CortexAgentManager.preflight() to surface missing permission grants and source objects in one pass.
  • Use CortexAgentManager.print_setup_sql() to generate the matching GRANT block.
  • Run python -m relationalai.agent.cortex.diagnostics to perform the same checks from the command line.

Bug Fixes

• Fixed a bug in relationalai.agent.cortex that could cause 404 errors during deployment.