Version 1.4.3 Date: May 16, 2024


  • Genv container toolkit supports docker exec commands


Version 1.4.2 Date: May 7, 2024


  • genv remote llm supports multiple Linux users

Version 1.4.1

Date: April 15, 2024


  • genv llm supports multiple Linux users

Version 1.4.0

Date: February 18, 2024


  • Introduced LLM support in Genv

  • Added command genv llm

  • Added command genv remote llm

  • Added command genv version


  • Passing environment variables over SSH commands

Version 1.3.0

Date: February 8, 2024


  • Supporting monitoring remote machines without Genv installed

  • Added metric genv_is_installed

  • Added metric genv_device_temperature

  • Added metric genv_device_memory_total_bytes

  • Implemented metric genv_device_utilization

  • Implemented metric genv_device_memory_used_bytes

  • New Grafana dashboard

  • Supporting passing SSH login names in genv remote with argument -l --username

Version 1.2.0

Date: July 4, 2023


  • Ray integration and genv.ray subpackage

Version 1.1.0

Date: June 21, 2023


  • Added flag --max-devices-for-user to genv enforce and genv remote enforce commands

Version 1.0.0

Date: June 12, 2023


  • Renamed Python CLI from genvctl to genv

  • Installation is now 100% Python-based

  • Moved Python source directory to the project root


  • Removed shell code base libexec/ entirely

Version 0.12.0

Date: May 30, 2023


  • Added genv.sdk.activate

  • Added genv.sdk.attach

  • Added genv.sdk.attached

  • Added genv.sdk.configure

  • Added genv.sdk.configuration


  • Merged executables into genvctl

Version 0.11.0

Date: May 15, 2023


  • Introducing the Genv CLI genvctl

  • Added CLI subcommand genvctl lock for locking over-subscribed devices as access control

  • Supporting over-subscription in container toolkit with genv-docker flag --over-subscribe

  • Added genv.sdk.env SDK package for the active environment

  • Supporting locking multiple devices in genv.core.devices.lock


  • Renamed genv.sdk.lock_devices to genv.sdk.lock

Version 0.10.1

Date: May 11, 2023


  • Fixed genv lock

Version 0.10.0

Date: May 7, 2023


  • Using global lock around critical sections instead of locking per module

  • Enriched core entities with more fields

  • Python package does not run executables in subprocesses anymore

  • Supporting cleaning up entities in place with .cleanup()

  • Bug fix in serialization of Report objects


  • Major restructure in project directory

  • Renamed Snapshot entities

  • Renamed genv.env to genv.sdk


  • Removed methods from genv.envs and genv.devices

Version 0.9.0

Date: May 1, 2023


  • Over-subscribe devices with new flag -o --over-subscribe to genv attach

  • New Python SDK at genv.env

  • Control access to over-subscribed devices with genv lock and genv.env.lock_devices()

  • Added fields and actions to genv.devices.Device and genv.devices.Snapshot


  • Renamed previous command genv-devices query to genv-devices find

  • Using genv.devices.Snapshot instead of plain JSON in genv-devices and devices.json (backwards compatible)


  • Removed environment variable GENV_ALLOW_DEVICE_OVER_ALLOCATION

Version 0.8.0

Date: April 13, 2023


  • Introduced Genv container toolkit: genv-docker and the Genv container runtime

  • Flags --count and --index are optional in genv-devices attach; if none passed, genv-devices attach uses the configured device count if set

  • Added genv.devices.attach()

  • Added genv.envs.gpus()

  • Added genv.envs.activate()

  • Added genv.envs.configure()


  • nvidia-smi shim prints warning message when missing information about processes

  • nvidia-smi shim supports the case when environment variable CUDA_VISIBLE_DEVICES is not set

  • nvidia-smi shim fails if no other nvidia-smi executable found

Version 0.7.0

Date: April 4, 2023


  • Added monitoring features with Prometheus and Grafana using genv monitor and genv remote monitor

Version 0.6.0

Date: February 14, 2023


  • Added enforcement rule env-devices

  • Added enforcement rule env-memory

  • Added command genv remote query

  • Added flag -t --timeout to genv remote to set SSH connection timeout

  • Added flag -e --exit-on-error to genv remote to exit on SSH connection issues

  • Added flag -q --quiet to genv remote to ignore SSH connection issues

  • Added flag --no-prompt to genv remote activate to not change shell prompt

  • Ignoring commented lines in hostfile used in genv remote

  • Added query uid to genv-envs query

  • Set up Google Analytics for documentation site


  • genv remote does not exit on SSH connection issues by default

  • Refactor entities and snapshots in genv Python package

  • Refactor remote capabilities in genv.remote Python subpackage

  • Combined enforcement rules code under genv.enforce.rules

  • Improved development setup and in particular nvidia-smi development shim and CPU-only setup for remote features

Version 0.5.0

Date: January 27, 2023


  • Introduced local and remote enforcement features with two enforcement rules: non environment processes and max devices per user

  • Added genv-usage executable for taking snapshots and executing enforcement reports

  • Supporting querying environment usernames

  • Added flag --quiet to genv-devices detach

  • Created devel directory and nvidia-smi mock shim

  • Added environment variable GENV_TERMINATE_PROCESSES to allow not terminating processes

  • Added environment variable GENV_MOCK_NVIDIA_SMI_PIDS to set process identifiers in the nvidia-smi mock shim


  • Created Python package genv

  • Major refactor to Python code by adding logic layers (e.g. genv.envs) and entities (e.g. genv.envs.Env)

  • Supporting encoding and decoding entities as JSON

  • Supporting sending standard input to SSH commands

  • Supporting running SSH commands with sudo

Version 0.4.0

Date: December 22, 2022


  • Listing active environments on remote hosts with genv remote envs

  • Showing device information on remote hosts with genv remote devices

  • Activating an environment on a remote host with genv remote activate


  • Formatting Python code with black

  • Linting Python code with flake8

Version 0.3.0

Date: November 24, 2022


  • Configuring environment GPU memory capacity

  • GPU memory aware device provisioning

  • Supporting device over allocation with multiple environments

  • Documentation site


  • docker shim injects environment variable GENV_ENVIRONMENT_ID to containers

  • Renamed environment variable GENV_DEVICES to GENV_MOCK_DEVICE_COUNT


  • nvidia-smi shim supports environment variables with =

  • docker shim supports the case when argument --gpus is not passed

  • nvidia-smi shim does not pass argument --id in bypass mode

Version 0.2.0

Date: November 3, 2022


  • nvidia-smi shim shows environment information only (i.e. memory, processes)

  • docker shim that exposes containers to devices attached to the environment

  • Environment variable GENV_BYPASS bypasses shims


  • nvidia-smi shim converted from Bash script to Python

Version 0.1.0

Date: September 22, 2022


  • Activating and deactivating environment

  • Querying environment status

  • Configuring environment name and device count

  • Clearing and printing environment configuration

  • Saving and loading environment configuration to and from disk

  • Attaching environment to devices and detaching from them

  • Listing active environments

  • Listing devices

  • nvidia-smi shim that shows information about attached devices only