Mlagents

Latest version: v1.1.0

Safety actively analyzes 706267 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

Page 9 of 14

0.9.2

New Features
- Added multi-gpu implementation for PPO. You can turn this on by using `--multi-gpu` option in [`mlagents-learn`](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Training-ML-Agents.md#command-line-training-options). In our own experiments we've observed a 38% boost on the update speed of Resnet using the [Obstacle Tower Environment](https://github.com/Unity-Technologies/obstacle-tower-env). (#2288)

Fixes and Improvements
- Improved the training performance by 20-30% when curiosity is used. We achieved this by updating the reward signal in parallel with the policy. (2362)
- Changed the Crawler example environment observation space to include relative observations. Increases performance in `CrawlerDynamic` scene. ([18f661](https://github.com/Unity-Technologies/ml-agents/commit/18f6616cdddd1b0dea14cabf169bed0e3245535f))
- Fixed a bug with online Behavior Cloning. (2384)
- Fixed a compile error on DemonstrationImporter.cs. ([b617de](https://github.com/Unity-Technologies/ml-agents/commit/b617de4401e3c9a362c6da70e5780f6c496faff0))

Acknowledgements

Thanks to everyone at Unity who contributed to v0.9.2, as well as: RunSwimFlyRich, niskander.

0.9.1

Fixes and Improvements
- Fixed issue where BC Trainer would not start.
- Fixed issue when using Demonstration Recorder with a LearningBrain.
- Fixed issue where Samplers would not use a consistent seed even when one is specified.
- Fix crash when using GAIL, Curiosity, and visual observations together.

0.9.0

New Features

* Added Generative Adversarial Imitation Learning ([GAIL](https://arxiv.org/abs/1606.03476)), a new way to do [imitation learning](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Training-Imitation-Learning.md). (#2118)
* Unlike Behavioral Cloning, which requires demonstrations that exhaustively cover all the scenarios that an agent could encounter, GAIL enables imitation learning from as few as 5-10 demonstrations. This makes GAIL more applicable to more problems than Behavioral Cloning, and less work (in recording demonstrations) to set up.
* GAIL can also be used with reinforcement learning to guide the behavior of the agent to be similar to the demonstrations. In environments where the reward is sparse, providing demonstrations can speed up training by several times. See [imitation learning](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Training-Imitation-Learning.md) for more information on how to use GAIL, and a comparison of training times on one of our example environments.
* Enabled [pre-training](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Training-Imitation-Learning.md) for the PPO trainer. (#2118)
* Pre-training can be used to bootstrap an agent's behavior using human-provided demonstrations, and helps the agent explore in the right direction during training. It can be used in conjunction with GAIL for further training speedup, especially in environments where the agent rarely sees a reward, or gets "stuck" in certain parts. See [imitation learning](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Training-Imitation-Learning.md) for more information on how to use pre-training.
* Introduced training generalized reinforcement learning agents. (2232)
* Agents trained in the same environment throughout the training process can learn to be really good at solving that particular problem. However, when introduced to variations in the environment (e.g., the terrain changes, the agent's physics changes slightly) these agents will fail.
* This release enables varying the environment during training, so that the trained agent is robust to environment variations. In addition, we've added changeable parameters to our example environments that enable them to train and test these generalized agents. See [Training Generalized Agents](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Training-Generalized-Reinforcement-Learning-Agents.md) to learn more about using this feature.
* Changed stepping of the environments to be done asynchronously when running multiple Unity environments. (2265)
* Prior to this change, ML-Agents waited for all the parallel environments to complete a step. For environments where some steps (e.g. reset) could take much longer than others, this slows the step collection time to the slowest step. Note that this changes the definition of "step" reported in TensorBoard when using multiple environments.
* Added options for [Nature](https://arxiv.org/abs/1312.5602) and [ResNet](https://arxiv.org/abs/1802.01561) CNN architectures when using visual observations. These larger networks may help with more complex visual observations. (#2289)
* Added basic [profiling in Python](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Profiling-Python.md) (#2180).

Fixes & Improvements
* Upgraded the Unity Inference Engine to 0.2.4, significantly reducing memory usage during inference (2308).
* Unified definition of reward sources in `trainer_config.yaml` across Curiosity, Extrinsic, and GAIL. (2144)
* Added support for gym wrapper and multiple visual observations. (2192)
* Added Korean documentation and localization (2219, 2356)
* Fixed custom reset parameters for `SubprocessEnvManager` (2242)
* Fixed spawning bug in VisualBanana example environment. (2277)
* Fixed memory leak when using visual observations in a Docker container (2274)
* Added ability to pass in Unity executable command line parameters while instantiating a UnityEnvironment. (2243)
* Included other minor bug and doc fixes

Workflow Changes
* Enabling Curiosity (as well as GAIL) is done under a new `reward_signals` parameter in the trainer configuration YAML file.
* When running training using multiple environments, the number of steps reported to TensorBoard now correspond to the number of steps taken per environment, not one per all environment.

See [Migrating](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Migrating.md) for more details on workflow changes.

Known Issues
In some rare cases, the model may not be saved when quitting with `Ctrl+C` on Windows. If this occurs, reload the model by running `mlagents-learn` using the `--load` parameter, and attempt saving again.

Acknowledgements

Thanks to everyone at Unity who contributed to v0.9.0, as well as: BlueFisher, shakenes, JangHyeonJun, Kyushik, erikfrey, gregnz, AcelisWeaven, rsfutch77, quevedin, and LuoYouRen.

0.8.2

New Features

* The [Unity Inference Engine](../release-v0.8.2/UnitySDK/Assets/ML-Agents/Plugins/Barracuda.Core/Barracuda.md) upgraded to version 0.2.2 with fixes for issues on discrete actions and visual observations.
* [Video recorder](https://github.com/Unity-Technologies/video-recorder).

Fixes & Improvements

* Added a script to automate the check for metafiles.
* Added no graphics option to gym wrapper.
* Ability to switch to a certain scene within a build before training starts.
* Added a script to turn on the control mode for all the brains in the example scenes.
* Various improvements to the documentation.
* Fixed the issue that the demo filenames might be too long and corrupt the demo files.
* Fixed the issue where the last action recorded by demonstration recorder in an episode was always 0.
* Fixed the null reference bug on demonstration recorder.
* Fixed a bug on parallel environment.
* External PRs require agreement to our Contributors License Agreement (both for individuals and on behalf of corporations)

Acknowledgements

Thanks to everyone at Unity who contributed to v0.8.2, as well as: TashaSkyUp, rsfutch77 , laurentopia, LeSphax, Gproulx, automata

0.8.1

Fixes & Performance Improvements
* Fix issues with `pypi` packaging of `mlagents` and `mlagents_envs`.

0.8.0

New Features
* Enable training with multiple concurrent Unity simulations.
* Ability to exchange custom protobuf messages.
* Support for 2D ray casting.
* Enable tracking and logging training metrics.
* Splitting ML-Agents package into `mlagents.trainers` and `mlagents.envs`.
* Ability to also use `RenderTexture` for Visual Observations.

Fixes & Performance Improvements
* Various improvements to the documentation.
* Various other bug fixes.

Known Issues

* Inference does not work with multi-discrete action when training with LSTM.

Acknowledgements

Thanks to everyone at Unity who contributed to v0.8.0, as well as: LeSphax, pyjamads, Tkggwatson, malmaud, Supercurious and rafvasq. Special thanks also go out to our partners [Jam City](https://www.jamcity.com/) who helped us evaluate the performance gains of this release on a real game, [Snoopy Pop](https://www.jamcity.com/snoopy-pop/).

Page 9 of 14

© 2025 Safety CLI Cybersecurity Inc. All Rights Reserved.