Changelog#

Listed here are the changes between each release of SmartSim and SmartRedis.

Jump to SmartRedis Changelog

SmartSim#

0.6.2#

Released on 16 February, 2024

Description

  • Patch SmartSim dependency version

Detailed Notes

  • A critical performance concern was identified and addressed in SmartRedis. A patch fix was deployed, and SmartSim was updated to ensure users do not inadvertently pull the unpatched version of SmartRedis. (SmartSim-PR493)

0.6.1#

Released on 15 February, 2024

Description

  • Duplicate for DBModel/Script prevented

  • Update license to include 2024

  • Telemetry monitor is now active by default

  • Add support for Mac OSX on Apple Silicon

  • Remove Torch warnings during testing

  • Validate Slurm timing format

  • Expose Python Typehints

  • Fix test_logs to prevent generation of directory

  • Fix Python Typehint for colocated database settings

  • Python 3.11 Support

  • Quality of life smart validate improvements

  • Remove Cobalt support

  • Enrich logging through context variables

  • Upgrade Machine Learning dependencies

  • Override sphinx-tabs background color

  • Add concurrency group to test workflow

  • Fix index when installing torch through smart build

Detailed Notes

  • Modify the git clone for both Redis and RedisAI to set the line endings to unix-style line endings when using MacOS on ARM. (SmartSim-PR482)

  • Separate install instructions are now provided for Mac OSX on x64 vs ARM64 (SmartSim-PR479)

  • Prevent duplicate ML model and script names being added to an Ensemble member if the names exists. (SmartSim-PR475)

  • Updates Copyright (c) 2021-2023 to Copyright (c) 2021-2024 in all of the necessary files. (SmartSim-PR485)

  • Bug fix which prevents the expected behavior when the SMARTSIM_LOG_LEVEL environment variable was set to developer. (SmartSim-PR473)

  • Sets the default value of the “enable telemetry” flag to on. Bumps the output manifest.json version number to match that of smartdashboard and pins a watchdog version to avoid build errors. (SmartSim-PR477)

  • Refactor logic of Manifest.has_db_objects to remove excess branching and improve readability/maintainability. (SmartSim-PR476)

  • SmartSim can now be built and used on platforms using Apple Silicon (ARM64). Currently, only the PyTorch backend is supported. Note that libtorch will be downloaded from a CrayLabs github repo. (SmartSim-PR465)

  • Tests that were saving Torch models were emitting warnings. These warnings were addressed by updating the model save test function. (SmartSim-PR472)

  • Validate the timing format when requesting a slurm allocation. (SmartSim-PR471)

  • Add and ship py.typed marker to expose inline type hints. Fix type errors related to SmartRedis. (SmartSim-PR468)

  • Fix the test_logs.py::test_context_leak test that was erroneously creating a directory named some value in SmartSim’s root directory. (SmartSim-PR467)

  • Add Python type hinting to colocated settings. (SmartSim-PR462)

  • Add github actions for running black and isort checks. (SmartSim-PR464)

  • Relax the required version of typing_extensions. (SmartSim-PR459)

  • Addition of Python 3.11 to SmartSim. (SmartSim-PR461)

  • Quality of life smart validate improvements such as setting CUDA_VISIBLE_DEVICES environment variable within smart validate prior to importing any ML deps to prevent false negatives on multi-GPU systems. Additionally, move SmartRedis logs from standard out to dedicated log file in the validation temporary directory as well as suppress sklearn deprecation warning by pinning KMeans constructor argument. Lastly, move TF test to last as TF may reserve the GPUs it uses. (SmartSim-PR458)

  • Some actions in the current GitHub CI/CD workflows were outdated. They were replaced with the latest versions. (SmartSim-PR446)

  • As the Cobalt workload manager is not used on any system we are aware of, its support in SmartSim was terminated and classes such as CobaltLauncher have been removed. (SmartSim-PR448)

  • Experiment logs are written to a file that can be read by the dashboard. (SmartSim-PR452)

  • Updated SmartSim’s machine learning backends to PyTorch 2.0.1, Tensorflow 2.13.1, ONNX 1.14.1, and ONNX Runtime 1.16.1. As a result of this change, there is now an available ONNX wheel for use with Python 3.10, and wheels for all of SmartSim’s machine learning backends with Python 3.11. (SmartSim-PR451) (SmartSim-PR461)

  • The sphinx-tabs documentation extension uses a white background for the tabs component. A custom CSS for those components to inherit the overall theme color has been added. (SmartSim-PR453)

  • Add concurrency groups to GitHub’s CI/CD workflows, preventing multiple workflows from the same PR to be launched concurrently. (SmartSim-PR439)

  • Torch changed their preferred indexing when trying to install their provided wheels. Updated the pip install command within smart build to ensure that the appropriate packages can be found. (SmartSim-PR449)

0.6.0#

Released on 18 December, 2023

Description

  • Conflicting directives in the SmartSim packaging instructions were fixed

  • sacct and sstat errors are now fatal for Slurm-based workflow executions

  • Added documentation section about ML features and TorchScript

  • Added TorchScript functions to Online Analysis tutorial

  • Added multi-DB example to documentation

  • Improved test stability on HPC systems

  • Added support for producing & consuming telemetry outputs

  • Split tests into groups for parallel execution in CI/CD pipeline

  • Change signature of Experiment.summary()

  • Expose first_device parameter for scripts, functions, models

  • Added support for MINBATCHTIMEOUT in model execution

  • Remove support for RedisAI 1.2.5, use RedisAI 1.2.7 commit

  • Add support for multiple databases

Detailed Notes

  • Several conflicting directives between the setup.py and the setup.cfg were fixed to mitigate warnings issued when building the pip wheel. (SmartSim-PR435)

  • When the Slurm functions sacct and sstat returned an error, it would be ignored and SmartSim’s state could become inconsistent. To prevent this, errors raised by sacct or sstat now result in an exception. (SmartSim-PR392)

  • A section named ML Features was added to documentation. It contains multiple examples of how ML models and functions can be added to and executed on the DB. TorchScript-based post-processing was added to the Online Analysis tutorial (SmartSim-PR411)

  • An example of how to use multiple Orchestrators concurrently was added to the documentation (SmartSim-PR409)

  • The test infrastructure was improved. Tests on HPC system are now stable, and issues such as non-stopped Orchestrators or experiments created in the wrong paths have been fixed (SmartSim-PR381)

  • A telemetry monitor was added to check updates and produce events for SmartDashboard (SmartSim-PR426)

  • Split tests into group_a, group_b, slow_tests for parallel execution in CI/CD pipeline (SmartSim-PR417, SmartSim-PR424)

  • Change format argument to style in Experiment.summary(), this is an API break (SmartSim-PR391)

  • Added support for first_device parameter for scripts, functions, and models. This causes them to be loaded to the first num_devices beginning with first_device (SmartSim-PR394)

  • Added support for MINBATCHTIMEOUT in model execution, which caps the delay waiting for a minimium number of model execution operations to accumulate before executing them as a batch (SmartSim-PR387)

  • RedisAI 1.2.5 is not supported anymore. The only RedisAI version is now 1.2.7. Since the officially released RedisAI 1.2.7 has a bug which breaks the build process on Mac OSX, it was decided to use commit 634916c from RedisAI’s GitHub repository, where such bug has been fixed. This applies to all operating systems. (SmartSim-PR383)

  • Add support for creation of multiple databases with unique identifiers. (SmartSim-PR342)

0.5.1#

Released on 14 September, 2023

Description

  • Add typehints throughout the SmartSim codebase

  • Provide support for Slurm heterogeneous jobs

  • Provide better support for PalsMpiexecSettings

  • Allow for easier inspection of SmartSim entities

  • Log ignored error messages from sacct

  • Fix colocated db preparation bug when using JsrunSettings

  • Fix bug when user specify CPU and devices greater than 1

  • Fix bug when get_allocation called with reserved keywords

  • Enabled mypy in CI for better type safety

  • Mitigate additional suppressed pylint errors

  • Update linting support and apply to existing errors

  • Various improvements to the smart CLI

  • Various documentation improvements

  • Various test suite improvements

Detailed Notes

  • Add methods to allow users to inspect files attached to models and ensembles. (SmartSim-PR352)

  • Add a smart info target to provide rudimentary information about the SmartSim installation. (SmartSim-PR350)

  • Remove unnecessary generation producing unexpected directories in the test suite. (SmartSim-PR349)

  • Add support for heterogeneous jobs to SrunSettings by allowing users to set the –het-group parameter. (SmartSim-PR346)

  • Provide clearer guidelines on how to contribute to SmartSim. (SmartSim-PR344)

  • Integrate PalsMpiexecSettings into the Experiment factory methods when using the “pals” launcher. (SmartSim-PR343)

  • Create public properties where appropriate to mitigate protected-access errors. (SmartSim-PR341)

  • Fix a failure to execute _prep_colocated_db due to incorrect named attr check. (SmartSim-PR339)

  • Enabled and mitigated mypy disallow_any_generics and warn_return_any. (SmartSim-PR338)

  • Add a smart validate target to provide a simple smoke test to assess a SmartSim build. (SmartSim-PR336, SmartSim-PR351)

  • Add typehints to smartsim._core.launcher.step.*. (SmartSim-PR334)

  • Log errors reported from slurm WLM when attempts to retrieve status fail. (SmartSim-PR331, SmartSim-PR332)

  • Fix incorrectly formatted positional arguments in log format strings. (SmartSim-PR330)

  • Ensure that launchers pass environment variables to unmanaged job steps. (SmartSim-PR329)

  • Add additional tests surrounding the RAI_PATH configuration environment variable. (SmartSim-PR328)

  • Remove unnecessary execution of unescaped shell commands. (SmartSim-PR327)

  • Add error if user calls get_allocation with reserved keywords in slurm get_allocation. (SmartSim-PR325)

  • Add error when user requests CPU with devices greater than 1 within add_ml_model and add_script. (SmartSim-PR324)

  • Update documentation surrounding ensemble key prefixing. (SmartSim-PR322)

  • Fix formatting of the Frontier site installation. (SmartSim-PR321)

  • Update pylint dependency, update .pylintrc, mitigate non-breaking issues, suppress api breaks. (SmartSim-PR311)

  • Refactor the smart CLI to use subparsers for better documentation and extension. (SmartSim-PR308)

0.5.0#

Released on 6 July, 2023

Description

A full list of changes and detailed notes can be found below:

  • Update SmartRedis dependency to v0.4.1

  • Fix tests for db models and scripts

  • Fix add_ml_model() and add_script() documentation, tests, and code

  • Remove requirements.txt and other places where dependencies were defined

  • Replace limit_app_cpus with limit_db_cpus for co-located orchestrators

  • Remove wait time associated with Experiment launch summary

  • Update and rename Redis conf file

  • Migrate from redis-py-cluster to redis-py

  • Update full test suite to not require a TF wheel at test time

  • Update doc strings

  • Remove deprecated code

  • Relax the coloredlogs version

  • Update Fortran tutorials for SmartRedis

  • Add support for multiple network interface binding in Orchestrator and Colocated DBs

  • Add typehints and static analysis

Detailed notes

  • Updates SmartRedis to the most current release (SmartSim-PR316)

  • Fixes and enhancements to documentation (SmartSim-PR317, SmartSim-PR314, SmartSim-PR287)

  • Various fixes and enhancements to the test suite (SmartSim-PR315, SmartSim-PR312, SmartSim-PR310, SmartSim-PR302, SmartSim-PR283)

  • Fix a defect in the tests related to database models and scripts that was causing key collisions when testing on workload managers (SmartSim-PR313)

  • Remove requirements.txt and other places where dependencies were defined. (SmartSim-PR307)

  • Fix defect where dictionaries used to create run settings can be changed unexpectedly due to copy-by-ref (SmartSim-PR305)

  • The underlying code for Model.add_ml_model() and Model.add_script() was fixed to correctly handle multi-GPU configurations. Tests were updated to run on non-local launchers. Documentation was updated and fixed. Also, the default testing interface has been changed to lo instead of ipogif. (SmartSim-PR304)

  • Typehints have been added. A makefile target make check-mypy executes static analysis with mypy. (SmartSim-PR295, SmartSim-PR301, SmartSim-PR303)

  • Replace limit_app_cpus with limit_db_cpus for co-located orchestrators. This resolves some incorrect behavior/assumptions about how the application would be pinned. Instead, users should directly specify the binding options in their application using the options appropriate for their launcher (SmartSim-PR306)

  • Simplify code in random_permutations parameter generation strategy (SmartSim-PR300)

  • Remove wait time associated with Experiment launch summary (SmartSim-PR298)

  • Update Redis conf file to conform with Redis v7.0.5 conf file (SmartSim-PR293)

  • Migrate from redis-py-cluster to redis-py for cluster status checks (SmartSim-PR292)

  • Update full test suite to no longer require a tensorflow wheel to be available at test time. (SmartSim-PR291)

  • Correct spelling of colocated in doc strings (SmartSim-PR290)

  • Deprecated launcher-specific orchestrators, constants, and ML utilities were removed. (SmartSim-PR289)

  • Relax the coloredlogs version to be greater than 10.0 (SmartSim-PR288)

  • Update the Github Actions runner image from macos-10.15` to macos-12`. The former began deprecation in May 2022 and was finally removed in May 2023. (SmartSim-PR285)

  • The Fortran tutorials had not been fully updated to show how to handle return/error codes. These have now all been updated. (SmartSim-PR284)

  • Orchestrator and Colocated DB now accept a list of interfaces to bind to. The argument name is still interface for backward compatibility reasons. (SmartSim-PR281)

  • Typehints have been added to public APIs. A makefile target to execute static analysis with mypy is available make check-mypy. (SmartSim-PR295)

0.4.2#

Released on April 12, 2023

Description

This release of SmartSim had a focus on polishing and extending exiting features already provided by SmartSim. Most notably, this release provides support to allow users to colocate their models with an orchestrator using Unix domain sockets and support for launching models as batch jobs.

Additionally, SmartSim has updated its tool chains to provide a better user experience. Notably, SmarSim can now be used with Python 3.10, Redis 7.0.5, and RedisAI 1.2.7. Furthermore, SmartSim now utilizes SmartRedis’s aggregation lists to streamline the use and extension of ML data loaders, making working with popular machine learning frameworks in SmartSim a breeze.

A full list of changes and detailed notes can be found below:

  • Add support for colocating an orchestrator over UDS

  • Add support for Python 3.10, deprecate support for Python 3.7 and RedisAI 1.2.3

  • Drop support for Ray

  • Update ML data loaders to make use of SmartRedis’s aggregation lists

  • Allow for models to be launched independently as batch jobs

  • Update to current version of Redis to 7.0.5

  • Add support for RedisAI 1.2.7, pyTorch 1.11.0, Tensorflow 2.8.0, ONNXRuntime 1.11.1

  • Fix bug in colocated database entrypoint when loading PyTorch models

  • Fix test suite behavior with environment variables

Detailed Notes

  • Running some tests could result in some SmartSim-specific environment variables to be set. Such environment variables are now reset after each test execution. Also, a warning for environment variable usage in Slurm was added, to make the user aware in case an environment variable will not be assigned the desired value with –export. (SmartSim-PR270)

  • The PyTorch and TensorFlow data loaders were update to make use of aggregation lists. This breaks their API, but makes them easier to use. (SmartSim-PR264)

  • The support for Ray was dropped, as its most recent versions caused problems when deployed through SmartSim. We plan to release a separate add-on library to accomplish the same results. If you are interested in getting the Ray launch functionality back in your workflow, please get in touch with us! (SmartSim-PR263)

  • Update from Redis version 6.0.8 to 7.0.5. (SmartSim-PR258)

  • Adds support for Python 3.10 without the ONNX machine learning backend. Deprecates support for Python 3.7 as it will stop receiving security updates. Deprecates support for RedisAI 1.2.3. Update the build process to be able to correctly fetch supported dependencies. If a user attempts to build an unsupported dependency, an error message is shown highlighting the discrepancy. (SmartSim-PR256)

  • Models were given a batch_settings attribute. When launching a model through Experiment.start the Experiment will first check for a non-nullish value at that attribute. If the check is satisfied, the Experiment will attempt to wrap the underlying run command in a batch job using the object referenced at Model.batch_settings as the batch settings for the job. If the check is not satisfied, the Model is launched in the traditional manner as a job step. (SmartSim-PR245)

  • Fix bug in colocated database entrypoint stemming from uninitialized variables. This bug affects PyTorch models being loaded into the database. (SmartSim-PR237)

  • The release of RedisAI 1.2.7 allows us to update support for recent versions of PyTorch, Tensorflow, and ONNX (SmartSim-PR234)

  • Make installation of correct Torch backend more reliable according to instruction from PyTorch

  • In addition to TCP, add UDS support for colocating an orchestrator with models. Methods Model.colocate_db_tcp and Model.colocate_db_uds were added to expose this functionality. The Model.colocate_db method remains and uses TCP for backward compatibility (SmartSim-PR246)

0.4.1#

Released on June 24, 2022

Description: This release of SmartSim introduces a new experimental feature to help make SmartSim workflows more portable: the ability to run simulations models in a container via Singularity. This feature has been tested on a small number of platforms and we encourage users to provide feedback on its use.

We have also made improvements in a variety of areas: new utilities to load scripts and machine learning models into the database directly from SmartSim driver scripts and install-time choice to use either KeyDB or Redis for the Orchestrator. The RunSettings API is now more consistent across subclasses. Another key focus of this release was to aid new SmartSim users by including more extensive tutorials and improving the documentation. The docker image containing the SmartSim tutorials now also includes a tutorial on online training.

Launcher improvements

Documentation and tutorials

General improvements and bug fixes

Dependency updates

0.4.0#

Released on Feb 11, 2022

Description: In this release SmartSim continues to promote ease of use. To this end SmartSim has introduced new portability features that allow users to abstract away their targeted hardware, while providing even more compatibility with existing libraries.

A new feature, Co-located orchestrator deployments has been added which provides scalable online inference capabilities that overcome previous performance limitations in seperated orchestrator/application deployments. For more information on advantages of co-located deployments, see the Orchestrator section of the SmartSim documentation.

The SmartSim build was significantly improved to increase customization of build toolchain and the smart command line inferface was expanded.

Additional tweaks and upgrades have also been made to ensure an optimal experience. Here is a comprehensive list of changes made in SmartSim 0.4.0.

Orchestrator Enhancements:

Emphasize Driver Script Portability:

  • Add ability to create run settings through an experiment (SmartSim-PR110)

  • Add ability to create batch settings through an experiment (SmartSim-PR112)

  • Add automatic launcher detection to experiment portability functions (SmartSim-PR120)

Expand Machine Learning Library Support:

Expand Launcher Setting Options:

  • Add ability to use base RunSettings on a Slurm, or PBS launchers (SmartSim-PR90)

  • Add ability to use base RunSettings on LFS launcher (SmartSim-PR108)

Deprecations and Breaking Changes

General Improvements and Bug Fixes:

Documentation Updates:

0.3.2#

Released on August 10, 2021

Description:

0.3.1#

Released on May 5, 2021

Description: This release was dedicated to making the install process easier. SmartSim can be installed from PyPI now and the smart cli tool makes installing the machine learning runtimes much easier.

0.3.0#

Released on April 1, 2021

Description:

  • initial 0.3.0 (first public) release of SmartSim


SmartRedis#

0.5.2#

Released on February 16, 2024

Description

  • Fixed bug which was sending tensors to the database twice (Python Client)

Detailed Notes

  • A previous bug fix for the Python client which addressed a problem when sending numpy views inadvertently kept the original put_tensor call in place. This essentially doubles the cost of the operation. (PR464)

0.5.1#

Released on February 15, 2024

Description

  • Fix bug when sending an array view

  • Add concurrency groups for Github Action testing

  • Update license to include 2024

  • Increase build space for Github Actions

  • Update README python versions

  • Expose Typehints

  • Update supported python versions [Add 3.11, remove 3.7]

  • Tweak the build system to enable building SmartRedis with Nvidia’s NVHPC toolchain

  • Improvements/upgrades to the container used for Github actions

  • Code updates to avoid compiler warnings

  • Added developer documentation on how to run a single test case and eliminated duplicative environment variables

  • Resolve a linting issue with pybind-to-python error propagation

  • Use mutable fields to enable Dataset get methods that store memory to be marked const

Detailed Notes

  • Detect whether the tensor the user is sending is a view and if so, make an explicit copy. (PR453)

  • Add support to concurrency groups in the run_tests workflow. (PR456)

  • Update license to include 2024. (PR454)

  • Add new Github Action that removes unneeded packages and resizes the root disk space. (PR455)

  • Update developer documentation to reflect newly supported versions of Python (PR450) (PR452)

  • Add and ship py.typed marker to expose inline type hints (PR451)

  • Deprecate support for Python 3.7 by removing from the allowed Python versions (PR450)

  • Update Python package dependencies to add support for Python 3.11 (PR450)

  • Change the order of arguments in our MakeFile to ensure that all dependencies are compiled with GCC (PR448)

  • Add new user-configurable parameters DEP_CC, DEP_CXX to control which compiler is used to build dependencies (PR448)

  • Ameliorate some compiler warnings related that were flagged in GCC 12 (unreachable code blocks, signed/unsigned mismatches) (PR448)

  • CI/CD: Bump the container version used in Github Actions Ubuntu 22.04 to be able to start testing GCC 12 (PR448)

  • CI/CD: Bump the versions of GCC used in testing to the currently maintained versions (PR448)

  • CI/CD: Add NVHPC to the testing matrix (PR448)

  • CI/CD: Test the shared/static compilations and examples with all compilers (PR448)

  • CI/CD: Compile Redis and RedisAI and use those versions in testing instead of extracting from a container (PR448)

  • CI/CD: Bump the version of Redis used in testing to 7.0.5, the same version as we use with SmartSim (PR448)

  • CI/CD: Pin the Torch version to 1.11.0, the same as supported in SmartSim (PR448)

  • Added developer documentation on how to run a single test case with the new test/build system and eliminated use of SMARTREDIS_TEST_DEVICE and SMARTREDIS_TEST_CLUSTER environment variables (PR445)

  • Resolve a linting issue with pybind-to-python error propagation by changing import format and narrowing the lookup of pybind error names to the error module (PR444)

  • Use mutable fields to enable Dataset get methods that store memory to be marked const (PR443)

0.5.0#

Released on December 18, 2023

Description

  • Unpin the Intel Fortran compiler in CI/CD

  • Added a missing space in an error message

  • Improved consistency of namespace declarations for C++ pybind interface

  • Improved const correctness of C++ Client

  • Improved const correctness of C++ Dataset

  • Updated documentation

  • Added test cases for all Client construction parameter combinations

  • Centralized dependency tracking to setup.cfg

  • Improved robustness of Python client construction

  • Updated Client and Dataset documentation

  • Expanded list of allowed characters in the SSDB address

  • Added coverage to SmartRedis Python API functions

  • Improved responsiveness of library when attempting connection to missing backend database

  • Moved testing of examples to on-commit testing in CI/CD pipeline

  • Added name retrieval function to the DataSet object

  • Updated RedisAI version used in post-commit check-in testing in Github pipeline

  • Allow strings in Python interface for Client.run_script, Client.run_script_multiGPU

  • Improved support for model execution batching

  • Added support for model chunking

  • Updated the third-party RedisAI component

  • Updated the third-party lcov component

  • Add link to contributing guidelines

  • Added link to contributing guidelines

  • Added support for multiple backend databases via a new Client constructor that accepts a ConfigOptions object

Detailed Notes

  • Unpin the Intel Fortran compiler in CI/CD. This requires running the compiler setup script twice, once for Fortran and once for other languages, since they’re on different releases (PR436)

  • Added a missing space in an error message (PR435)

  • Made the declaration of the py namespace in py*.h consistently outside the SmartRedis namespace declaration (PR434)

  • Fields in several C++ API methods are now properly marked as const (PR430)

  • The Dataset add_tensor method is now const correct, as are all internal the methods it calls (PR427)

  • Some broken links in the documentation were fixed, and the instructions to run the tests were updated (PR423)

  • Added test cases for all Client construction parameter combinations (PR422)

  • Merged dependency lists from requirements.txt and requirements-dev.txt into setup.cfg to have only one set of dependencies going forward (PR420)

  • Improved robustness of Python client construction by adding detection of invalid kwargs (PR419), (PR421)

  • Updated the Client and Dataset API documentation to clarify which interacts with the backend db (PR416)

  • The SSDB address can now include ‘-’ and ‘_’ as special characters in the name. This gives users more options for naming the UDS socket file (PR415)

  • Added tests to increase Python code coverage

  • Employed a Redis++ ConnectionsObject in the connection process to establish a TCP timeout of 100ms during connection attempts (PR413)

  • Moved testing of examples to on-commit testing in CI/CD pipeline (PR412)

  • Added a function to the DataSet class and added a test

  • Updated RedisAI version used in post-commit check-in testing in Github pipeline to a version that supports fetch of model chunking size (PR408)

  • Allow users to pass single keys for the inputs and outputs parameters as a string for Python run_script and run_script_multigpu

  • Exposed access to the Redis.AI MINBATCHTIMEOUT parameter, which limits the delay in model execution when trying to accumulate multiple executions in a batch (PR406)

  • Models will now be automatically chunked when sent to/received from the backed database. This allows use of models greater than 511MB in size. (PR404)

  • Updated from RedisAI v1.2.3 (test target)/v1.2.4 and v1.2.5 (CI/CD pipeline) to v1.2.7 (PR402)

  • Updated lcov from version 1.15 to 2.0 (PR396)

  • Create CONTRIBUTIONS.md file that points to the contribution guideline for both SmartSim and SmartRedis (PR395)

  • Migrated to ConfigOptions-based Client construction, adding multiple database support (PR353)

0.4.2#

Released on September 13, 2023

Description

  • Reduced number of suppressed lint errors

  • Expanded documentation of aggregation lists

  • Updated third-party software dependencies to current versions

  • Updated post-merge tests in CI/CD to work with new test system

  • Enabled static builds of SmartRedis

  • Improve robustness of test runs

  • Fixed installation link

  • Updated supported languages documentation

  • Removed obsolete files

  • Added pylint to CI/CD pipeline and mitigate existing errors

  • Improved clustered redis initialization

Detailed Notes

  • Refactor factory for ConfigOptions to avoid using protected member outside an instance (PR393)

  • Added a new advanced topics documentation page with a section on aggregation lists (PR390)

  • Updated pybind (2.10.3 => 2.11.1), hiredis (1.1.0 => 1.2.0), and redis++ (1.3.5 => 1.3.10) dependencies to current versions (PR389)

  • Post-merge tests in CI/CD have been updated to interface cleanly with the new test system that was deployed in the previous release (PR388)

  • Static builds of SmartRedis can now work with Linux platforms. Fortran is tested with GNU, PGI, Intel compilers (PR386)

  • Preserve the shell output of test runs while making sure that server shutdown happens unconditionally (PR381)

  • Fix incorrect link to installation documentation (PR380)

  • Update language support matrix in documentation to reflect updates from the last release (PR379)

  • Fix typo causing startup failure in utility script for unit tests (PR378)

  • Update pylint configuration and version, mitigate most errors, execute in CI/CD pipeline (PR371, PR382)

  • Deleted obsolete build and testing files that are no longer needed with the new build and test system (PR366)

  • Reuse existing redis connection when mapping the Redis cluster (PR364)

0.4.1#

Released on July 5, 2023

Description

This release revamps the build and test systems for SmartRedis as well as improving compatibility with different Fortran compilers and laying the groundwork for future support for interacting with multiple concurrent backend databases:

  • Documentation improvements

  • Improved compatibility of type hints with third-party software

  • Added type hints to the Python interface layer

  • Add support for Python 3.10

  • Updated setup.py to work with the new build system

  • Remove unneeded method from Python SRObject class

  • Fixed a memory leak in the C layer

  • Revamp SmartRedis test system

  • Remove debug output in pybind layer

  • Update Hiredis version to 1.1.0

  • Enable parallel build for the SmartRedis examples

  • Experimental support for Nvidia toolchain

  • Major revamp of build and test systems for SmartRedis

  • Refactor Fortran methods to return default logical kind

  • Update CI/CD tests to use a modern version of MacOS

  • Fix the spelling of the Dataset destructor’s C interface (now DeallocateDataSet)

  • Update Redis++ version to 1.3.8

  • Refactor third-party software dependency installation

  • Add pip-install target to Makefile to automate this process going forward (note: this was later removed)

  • Added infrastructure for multiDB support

Detailed Notes

  • Assorted updates and clarifications to the documentation (PR367)

  • Turn ParamSpec usage into forward references to not require typing-extensions at runtime (PR365)

  • Added type hints to the Python interface layer (PR361)

  • List Python 3.10 support and loosen PyTorch requirement to allow for versions support Python 3.10 (PR360)

  • Streamlined setup.py to simplify Python install (PR359)

  • Remove from_pybind() from Python SRObject class as it’s not needed and didn’t work properly anyway (PR358)

  • Fixed memory leaked from the C layer when calling get_string_option() (PR357)

  • Major revamp to simplify use of SmartRedis test system, automating most test processes (PR356)

  • Remove debug output in pybind layer associated with put_dataset (PR352)

  • Updated to the latest version of Hiredis (1.1.0) (PR351)

  • Enable parallel build for the SmartRedis examples by moving utility Fortran code into a small static library (PR349)

  • For the NVidia toolchain only: Replaces the assumed rank feature of F2018 used in the Fortran client with assumed shape arrays, making it possible to compile SmartRedis with the Nvidia toolchain. (PR346)

  • Rework the build and test system to improve maintainability of the library. There have been several significant changes, including that Python and Fortran clients are no longer built by defaults and that there are Make variables that customize the build process. Please review the build documentation and make help to see all that has changed. (PR341)

  • Many Fortran routines were returning logical kind = c_bool which turns out not to be the same default kind of most Fortran compilers. These have now been refactored so that users need not import iso_c_binding in their own applications (PR340)

  • Update MacOS version in CI/CD tests from 10.15 to 12.0 (PR339)

  • Correct the spelling of the C DataSet destruction interface from DeallocateeDataSet to DeallocateDataSet (PR338)

  • Updated the version of Redis++ to v1.3.8 to pull in a change that ensures the redis++.pc file properly points to the generated libraries (PR334)

  • Third-party software dependency installation is now handled in the Makefile instead of separate scripts

  • New pip-install target in Makefile will be a dependency of the lib target going forward so that users don’t have to manually pip install SmartRedis in the future (PR330)

  • Added ConfigOptions class and API, which will form the backbone of multiDB support (PR303)

0.4.0#

Released on April 12, 2023

Description

This release provides a variety of features to improve usability and debugging of the SmartRedis library, notably including Unix domain socket support, logging, the ability to print a textual representation of a string or dataset, dataset inspection, documentation updates, fixes to the multi-GPU support, and much more:

  • Prepare 0.4.0 release

  • Disable codecov CI tests

  • Improved error message in to_string methods in C interface

  • Streamlined PyBind interface layer

  • Updated Python API documentation

  • Streamlined C interface layer

  • Improved performance of get, put, and copy dataset methods

  • Fix a bug which prevented multi-GPU model set in some cases

  • Streamline pipelined execution of tasks for backend database

  • Enhance code coverage to include all 4 languages supported by SmartRedis

  • Fix a bug which resulted in wrong key prefixing when retrieving aggregation lists in ensembles

  • Correct assorted API documentation errors and omissions

  • Improve documentation of exception handling in Redis server classes

  • Improve error handling for setting of scripts and models

  • Add support to inspect the dimensions of a tensor via get_tensor_dims()

  • Split dataset prefixing control from use_tensor_ensemble_prefix() to use_dataset_ensemble_prefix()

  • Update to the latest version of redis-plus-plus

  • Update to the latest version of PyBind

  • Change documentation theme to sphinx_book_theme and fix doc strings

  • Add print capability for Client and DataSet

  • Add support for inspection of tensors and metadata inside datasets

  • Add support for user-directed logging for Python clients, using Client, Dataset, or LogContext logging methods

  • Add support for user-directed logging for C and Fortran clients without a Client or Dataset context

  • Additional error reporting for connections to and commands run against Redis databases

  • Improved error reporting capabilities for Fortran clients

  • Python error messages from SmartRedis contain more information

  • Added logging functionality to the SmartRedis library

  • A bug related to thread pool initialization was fixed.

  • This version adds new functionality in the form of support for Unix Domain Sockets.

  • Fortran client can now be optionally built with the rest of the library

  • Initial support for dataset conversions, specifically Xarray.

Detailed Notes

  • Update docs and version numbers in preparation for version 0.4.0. Clean up duplicate marking of numpy dependency (PR321)

  • Remove codecov thresholds to avoid commits being marked as ‘failed’ due to coverage variance (PR317)

  • Corrected the error message in to_string methods in C interface to not overwrite the returned error message and to name the function (PR320)

  • Streamlined PyBind interface layer to reduce repetitive boilerplate code (PR315)

  • Updated Python API summary table to include new methods (PR313)

  • Streamlined C interface layer to reduce repetitive boilerplate code (PR312)

  • Leveraged Redis pipelining to improve performance of get, put, and copy dataset methods (PR311)

  • Redis::set_model_multigpu() will now upload the correct model to all GPUs (PR310)

  • RedisCluster::_run_pipeline() will no longer unconditionally apply a retry wait before returning (PR309)

  • Expand code coverage to all four languages and make the CI/CD more efficent (PR308)

  • An internal flag was set incorrectly, it resulted in wrong key prefixing when accessing (retrieving or querying) lists created in ensembles (PR306)

  • Corrected a variety of Doxygen errors and omissions in the API documentation (PR305)

  • Added throw documentation for exception handling in redis.h, redisserver.h, rediscluster.h (PR301)

  • Added error handling for a rare edge condition when setting scripts and models (PR300)

  • Added support to inspect the dimensions of a tensor via new get_tensor_dims() method (PR299)

  • The use_tensor_ensemble_prefix() API method no longer controls whether datasets are prefixed. A new API method, use_dataset_ensemble_prefix() now manages this. (PR298)

  • Updated from redis-plus-plus v1.3.2 to v1.3.5 (PR296)

  • Updated from PyBind v2.6.2 to v2.10.3 (PR295)

  • Change documentation theme to sphinx_book_theme to match SmartSim documentation theme and fix Python API doc string errors (PR294)

  • Added print capability for Client and DataSet to give details diagnostic information for debugging (PR293)

  • Added support for retrieval of names and types of tensors and metadata inside datasets (PR291)

  • Added support for user-directed logging for Python clients via {Client, Dataset, LogContext}.{log_data, log_warning, log_error} methods (PR289)

  • Added support for user-directed logging without a Client or Dataset context to C and Fortran clients via _string() methods (PR288)

  • Added logging to capture transient errors that arise in the _run() and _connect() methods of the Redis and RedisCluster classes (PR287)

  • Tweak direct testing of Redis and RedisCluster classes (PR286)

  • Resolve a disparity in the construction of Python client and database classes (PR285)

  • Fortran clients can now access error text and source location (PR284)

  • Add exception location information from CPP code to Python exceptions (PR283)

  • Added client activity and manual logging for developer use (PR281)

  • Fix thread pool error (PR280)

  • Update library linking instructions and update Fortran tester build process (PR277)

  • Added add_metadata_for_xarray and transform_to_xarray methods in DatasetConverter class for initial support with Xarray (PR262)

  • Change Dockerfile to use Ubuntu 20.04 LTS image (PR276)

  • Implemented support for Unix Domain Sockets, including refactorization of server address code, test cases, and check-in tests. (PR252)

  • A new make target make lib-with-fortran now compiles the Fortran client and dataset into its own library which applications can link against (PR245)

0.3.1#

Released on June 24, 2022

Description

Version 0.3.1 adds new functionality in the form of DataSet aggregation lists for pipelined retrieval of data, convenient support for multiple GPUs, and the ability to delete scripts and models from the backend database. It also introduces multithreaded execution for certain tasks that span multiple shards of a clustered database, and it incorporates a variety of internal improvements that will enhance the library going forward.

Detailed Notes

  • Implemented DataSet aggregation lists in all client languages, for pipelined retrieval of data across clustered and non-clustered backend databases. (PR258) (PR257) (PR256) (PR248) New commands are:

    • append_to_list()

    • delete_list()

    • copy_list()

    • rename_list()

    • get_list_length()

    • poll_list_length()

    • poll_list_length_gte()

    • poll_list_length_lte()

    • get_datasets_from_list()

    • get_dataset_list_range()

    • use_list_ensemble_prefix()

  • Implemented multithreaded execution for parallel dataset list retrieval on clustered databases. The number of threads devoted for this purpose is controlled by the new environment variable SR_THERAD_COUNT. The value defaults to 4, but may be any positive integer or special value zero, which will cause the SmartRedis runtime to allocate one thread for each available hardware context. (PR251) (PR246)

  • Augmented support for GPUs by implementing multi-GPU convenience functions for all client languages. (PR254) (PR250) (PR244) New commands are:

    • set_model_from_file_multigpu()

    • set_model_multigpu()

    • set_script_from_file_multigpu()

    • set_script_multigpu()

    • run_model_multigpu()

    • run_script_multigpu()

    • delete_model_multigpu()

    • delete_script_multigpu()

  • Added API calls for all clients to delete models and scripts from the backend database. (PR240) New commands are:

    • delete_script()

    • delete_model()

  • Updated the use of backend RedisAI API calls to discontinue use of deprecated methods for model selection (AI.MODELSET) and execution (AI.MODELRUN) in favor of current methods AI.MODELSTORE and AI.MODELEXECUTE, respectively. (PR234)

  • SmartRedis will no longer call the C runtime method srand() to ensure that it does not interfere with random number generation in client code. It now uses a separate instance of the C++ random number generator. (PR233)

  • Updated the way that the Fortran enum_kind type defined in the fortran_c_interop module is defined in order to better comply with Fortran standard and not interfere with GCC 6.3.0. (PR231)

  • Corrected the spelling of the word “command” in a few error message strings. (PR221)

  • SmartRedis now requires a CMake version 3.13 or later in order to utilize the add_link_options CMake command. (PR217)

  • Updated and improved the documentation of the SmartRedis library. In particular, a new SmartRedis Integration Guide provides an introduction to using the SmartRedis library and integrating it with existing software. (PR261) (PR260) (PR259) (SSPR214)

  • Added clustered Redis testing to automated GitHub check-in testing. (PR239)

  • Updated the SmartRedis internal API for building commands for the backend database. (PR223) This change should not be visible to clients.

  • The SmartRedis example code is now validated through the automated GitHub checkin process. This will help ensure that the examples do not fall out of date. (PR220)

  • Added missing copyright statements to CMakeLists.txt and the SmartRedis examples. (PR219)

  • Updated the C++ test coverage to ensure that all test files are properly executed when running “make test”. (PR218)

  • Fixed an internal naming conflict between a local variable and a class member variable in the DataSet class. (PR215) This should not be visible to clients.

  • Updated the internal documentation of methods in SmartRedis C++ classes with the override keyword to improve compliance with the latest C++ standards. (PR214) This change should not be visible to clients.

  • Renamed variables internally to more cleanly differentiate between names that are given to clients for tensors, models, scripts, datasets, etc., and the keys that are used when storing them in the backend database. (PR213) This change should not be visible to clients.

0.3.0#

Released on Febuary 11, 2022

Description

  • Improve error handling across all SmartRedis clients (PR159) (PR191) (PR199) (PR205) (PR206)

    • Includes changes to C and Fortran function prototypes that are not backwards compatible

    • Includes changes to error class names and enum type names that are not backwards compatible

  • Add poll_dataset functionality to all SmartRedis clients (PR184)

    • Due to other breaking changes made in this release, applications using methods other than poll_dataset to check for the existence of a dataset should now use poll_dataset

  • Add environment variables to control client connection and command timeout behavior (PR194)

  • Add AI.INFO command to retrieve statistics on scripts and models via Python and C++ clients (PR197)

  • Create a Dockerfile for SmartRedis (PR180)

  • Update redis-plus-plus version to 1.3.2 (PR162)

  • Internal client performance and API improvements (PR138) (PR141) (PR163) (PR203)

  • Expose Redis FLUSHDB, CONFIG GET, CONFIG SET, and SAVE commands to the Python client (PR139) (PR160)

  • Extend inverse CRC16 prefixing to all hash slots (PR161)

  • Improve backend dataset representation to enable performance optimization (PR195)

  • Simplify SmartRedis build proccess (PR189)

  • Fix zero-length array transfer in Fortran convert_char_array_to_c (PR170)

  • Add continuous integration for all SmartRedis tests (PR165) (PR173) (PR177)

  • Update SmartRedis docstrings (PR200) (PR207)

  • Update SmartRedis documentation and examples (PR202) (PR208) (PR210)

0.2.0#

Released on August, 5, 2021

Description

  • Improved tensor memory management in the Python client (PR70)

  • Improved metadata serialization and removed protobuf dependency (PR61)

  • Added unit testing infrastructure for the C++ client (PR96)

  • Improve command execution fault handling (PR65) (PR97) (PR105)

  • Bug fixes (PR52) (PR72) (PR76) (PR84)

  • Added copy, rename, and delete tensor and DataSet commands in the Python client (PR66)

  • Upgrade to RedisAI 1.2.3 (PR101)

  • Fortran and C interface improvements (PR93) (PR94) (PR95) (PR99)

  • Add Redis INFO command execution to the Python client (PR83)

  • Add Redis CLUSTER INFO command execution to the Python client (PR105)

0.1.1#

Released on May 5, 2021

Description

  • Compiled client library build and install update to remove environment variables (PR47)

  • Pip install for Python client (PR45)

0.1.0#

Released on April 1, 2021

Description

  • Initial 0.1.0 release of SmartRedis