Python package and CLI 1.0.7

Mar 21, 2026, 2:43 PM UTC

PyRel 1.0.7 moves auto_suspend_mins to rai reasoners:alter and await_storage_vacuum to rai reasoners:create instead of raiconfig.yaml.

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

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

New Features and Enhancements

Added Relationship.ref() for relationships declared directly, not attached to a concept attribute. Before, if you used the same standalone relationship twice in one query, PyRel treated both uses as the same query occurrence, so they could not match independently. Now, Relationship.ref() gives you a second occurrence of the same relationship definition, similar to Chain.ref().
Debugger UI packages are now optional. Before, a standard PyRel install included nicegui even if you did not use the debugger. Now a standard install stays smaller, and if you do use the debugger without its extra packages, PyRel tells you to install relationalai[debugger].

Fixed select() with not_() so select(not_(expr)) evaluates to a boolean result. Before, selecting a negated expression did not behave the same way as selecting other boolean expressions such as x == 2. Now select(not_(expr)) works like a normal boolean selection.

auto_suspend_mins and await_storage_vacuum are no longer managed in raiconfig.yaml. Before, these reasoner lifecycle settings could appear in raiconfig.yaml, and rai init --migrate could carry them over when converting raiconfig.toml to raiconfig.yaml. Now PyRel warns if they appear in config and leaves them out of the generated raiconfig.yaml during migration. Manage auto_suspend_mins with rai reasoners:alter. Set await_storage_vacuum when you create a reasoner with rai reasoners:create. For broader reasoner configuration, see Configure reasoners.