clearml-docs/docs/release_notes/ver_1_0.md

title
Version 1.0

ClearML 1.0.0

Breaking Changes

• Arguments order changed in Logger.report_line_plot(), Logger.report_plotly() and Logger.report_matplotlib_figure() - please use keywords instead of positional arguments

Features

• Add OS environemt variable CLEARML_DEFAULT_OUTPUT_URI to override default output_uri for automatic models upload - ClearML GitHub issue 328
• Add Task.force_requirements_env_freeze() forcing pip freeze instead of package analysis - ClearML GitHub issue 304
• Improve pipeline support
  • Add Task parameters override in ClearmlJob - ClearML GitHub issue 214
  • Add PipelineController node skip visualization and pre/post-execution callback
• Allow enabling/disabling tensorboard auto-connect using Task.init(auto_connect_frameworks={'tensorboard': True/False}) (default: True)
• Allow to continue running from previous execution iteration
• Support stopping instead of resetting in Task.execute_remotely() when server supports enqueueing stopped tasks
• Add Model query interface using Model.query_models()
• Support storing dict with "." in the keys using Task.connect_configuration
• Add force argument to Task.mark_failed() to allow setting Task status to failed regardless of Task state
• Add docker_args and docker_bash_setup_script arguments to Task.create()
• Change Logger plot iteration argument default to 0 (or None)
• Add task filtering in Task.get_task() using the allow_archived and task_filter arguments
• Add Task.get_configuration_objects() for reteriving configuration object as a blob of text in automation use-cases (instead of using Task.connect_configuration())
• Improved pipeline support
  • Add pipeline step caching
  • Add Pipeline controller caching
  • Improve pipeline plot reporting
  • Add PipelineController into main namespace (use from clearml import PipelineController)
• Add jupyter notebook preview update time stamp
• Change default metric report flushing to every 5 seconds
• Improve Task.artifacts for safer Task multi node use cases
• Support ClearML server API v2.13
• Add Python 3.9 to the support table
• Improve documentation and examples
  • Improve documentation for clearml-data, clearml-task
  • Add multiple_tasks_single_process example script for multiple Tasks created in same code
  • Add using_artifacts_example and execute_remotely_example example scripts
  • Update requirements.txt for KerasTuner example

Bug Fixes

• Fix \r and \n in debug samples title/series - ClearML GitHub issue 323
• Fix Google API credentials without storage section raises exception on import - ClearML GitHub issue 331
• Fix Matplotlib automagic export legend not showing series names - ClearML GitHub issue 337
• Fix Task.set_comment/name() passing None should be equivalent to ''
• Fix Task.set_credentials() uses incorrect config file when both trains.conf and clearml.conf are found
• Fix Task.set_credetnials() should override settings from config file
• Fix Keras h5 model storage
• Fix Task.execute_remotely() with sub process
• Fix Task requirements should conform to strings
• Fix reporting after task closing
• Fix remove deprecation warning with matplotlib 3.1
• Fix dataset create single root plot
• Fix Model.task should return task ID
• Fix code hangs when leaving process
• Fix flushing on CR timeout (default 10sec)
• Wait for subprocess when terminating
• Improve flush behaviour on KeyboardInterrupt exception
• Wait for subprocesses to flush when terminating
• Fix Task.set_credentials() with store_conf_file=True

ClearML Agent 1.0.0

Features

• Add conda and pip environment debug prints (using --debug)
• Add support for PyJWT v2
• Change the default conda channel order, so it pulls the correct pytorch package
• Improve k8s glue support
  • Support k8s glue container env vars merging
  • Add number of pods limit to k8s glue using the max_pods_limit argument (use --max-pods switch in the k8s glue example)
  • Add k8s glue default restartPolicy=Never to template to prevent pods from restarting
• Add --stop switch support for dynamic gpus
• Verify docker command exists when running in docker mode
• Add support for terminating dockers on sig_term in dynamic mode
• Add stopping message on Task process termination
• Add agent.docker_install_opencv_libs configuration option to enable automatic opencv libs install for faster docker spin-up (default: true, see here)
• Add support for new container base setup script feature
• Bump virtualenv dependency version (support v>=16,<21)
• Add support for dynamic gpus opportunistic scheduling (with min/max gpus per queue)
• Deprecate venv_update in configuration (replaced by the more robust venvs_cache)
• Add Python 3.9 to the support table

Bug Fixes

• Fix agent can return non-zero error code and pods will end up restarting forever - clearml-agent GitHub Issue 56
• Fix poetry support - clearml-agent GitHub Issue 57
• Fix cuda version from driver does not return minor version
• Fix requirements local path replace back when using cache
• Fix k8s glue
  • Fix broken k8s glue docker args parsing
  • Fix empty env prevents override when merging template
• Fix venv cache crash on bad symbolic links
• Fix no docker arguments provided

ClearML Server 1.0.0

Features

• Add Multi-level project hierarchy - Projects can now contain sub-projects
• Add markdown editor for project overview
• Add support for multiple models per experiment
• Add Context menu batch operations - ClearML GitHub issue 286
• Add global search regex support - ClearML GitHub issue 81
• Add support for extended container (docker) configuration and init script
• Add special character support ("." (dot) and "$") in Hyper Paramters
• Add new context menu icons
• Add deleting experiments and models through UI - ClearML GitHub issues 53, 61 and 81
• Improve Project deletion: deletes project's experiments and models.
• Add experiment description access from info title
• Improve experiment table columns
  • Add filter by user
  • Add filters time columns
  • Add filters for custom columns (metrics and hyper parameters)
  • Add secondary nested sorting
• Add worker<->queue clickable reference in workers and queues tables
• Add presenting all metric debug samples concurrently
• Add Full project name display in project cards - ClearML GitHub issue 81
• Add option for continuing aborted tasks

Bug Fixes

• Fix UI storage credentials input missing for HTML artifacts
• Fix sorting custom metric columns sort treats empty fields as zeroes
• Fix UI experiments table redundant rendering on auto refresh
• Fix missing URL encoding for hyper parameters key names
• Fix UI experiment section edit opens outside viewable screen
• Fix UI missing default selection of artifacts in full screen view
• Fix UI variant name not shown in plots
• Fix UI missing tooltip for truncated column headers
• Fix UI custom columns choice does not persist per project - ClearML GitHub issue 314
• Fix API plot_str not returned for compressed plots
• Fix UI plots color picker consistency
• Fix API Tasks.reset marking parent id as 'deleted' in its children
• Fix UI missing queue selection on queue delete
• Fix UI debug image history slider not shown when there's only a single iteration
• Fix UI X-axis labels are being cut in plots - ClearML GitHub issue 264
• Fix UI scalar color choice dialog toggles between screen positions every time you open it
• Fix UI hovering on legend clears parallel coordinates graph filters - ClearML GitHub issue 259
• Fix UI experiment comparison 'hide identical fields' button disable doesn't work
• Fix UI auto refresh removes model ID in model panel
• Fix UI debug samples download image opens new tab instead of downloading
• Fix UI experiment/model tables: Right most column is not fixed to right edge of screen
• Fix UI 'Add experiment' modal in compare scalar comparison intertwines with comparison display
• Fix UI experiment configurations showing redundant "General" section