x-ppo 0.0.1__py3-none-any.whl

x_ppo/__init__.py

@@ -0,0 +1 @@
+from x_ppo.ppo import ppo_actor_loss

x_ppo/ppo.py

@@ -0,0 +1,30 @@
+import torch
+from torch_einops_utils import z_score, masked_mean
+
+# helpers
+
+def exists(val):
+    return val is not None
+
+def ppo_actor_loss(
+    action_log_probs,
+    old_action_log_probs,
+    advantages,
+    eps_clip = 0.2,
+    mask = None,
+    normalize_advantages = False
+):
+    if normalize_advantages:
+        advantages = z_score(advantages, mask = mask)
+
+    ratios = (action_log_probs - old_action_log_probs).exp()
+
+    surr1 = ratios * advantages
+    surr2 = ratios.clamp(1. - eps_clip, 1. + eps_clip) * advantages
+
+    loss = - torch.min(surr1, surr2)
+
+    if not exists(mask):
+        return loss
+
+    return masked_mean(loss, mask = mask)

x_ppo-0.0.1.dist-info/METADATA

@@ -0,0 +1,278 @@
+Metadata-Version: 2.5
+Name: x-ppo
+Version: 0.0.1
+Summary: PPO
+Project-URL: Homepage, https://pypi.org/project/x-ppo/
+Project-URL: Repository, https://github.com/lucidrains/x-ppo
+Author-email: Phil Wang <lucidrains@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2020 Phil Wang
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: artificial intelligence,deep learning,proximal policy optimization,reinforcement learning
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: torch-einops-utils>=0.1.24
+Requires-Dist: torch>=2.4
+Provides-Extra: examples
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Description-Content-Type: text/markdown
+
+<img src="./lunar.gif" width="400px"></img>
+
+*1k steps*
+
+## PPO
+
+An implementation of PPO with recent random improvements
+
+The phasic part has been removed, repository to be renamed. I do not think it does anything
+
+## Install
+
+```bash
+$ pip install -r requirements.txt
+```
+
+You may need to install `swig`
+
+```bash
+$ apt install swig
+```
+
+## Use
+
+```bash
+$ python train.py
+```
+
+## Citations
+
+```bibtex
+@article{Schulman2017ProximalPO,
+    title   = {Proximal Policy Optimization Algorithms},
+    author  = {John Schulman and Filip Wolski and Prafulla Dhariwal and Alec Radford and Oleg Klimov},
+    journal = {ArXiv},
+    year    = {2017},
+    volume  = {abs/1707.06347},
+    url     = {https://api.semanticscholar.org/CorpusID:28695052}
+}
+```
+
+```bibtex
+@article{Zhang2024ReLU2WD,
+    title   = {ReLU2 Wins: Discovering Efficient Activation Functions for Sparse LLMs},
+    author  = {Zhengyan Zhang and Yixin Song and Guanghui Yu and Xu Han and Yankai Lin and Chaojun Xiao and Chenyang Song and Zhiyuan Liu and Zeyu Mi and Maosong Sun},
+    journal = {ArXiv},
+    year    = {2024},
+    volume  = {abs/2402.03804},
+    url     = {https://api.semanticscholar.org/CorpusID:267499856}
+}
+```
+
+```bibtex
+@inproceedings{Lee2024SimBaSB,
+    title  = {SimBa: Simplicity Bias for Scaling Up Parameters in Deep Reinforcement Learning},
+    author = {Hojoon Lee and Dongyoon Hwang and Donghu Kim and Hyunseung Kim and Jun Jet Tai and Kaushik Subramanian and Peter R. Wurman and Jaegul Choo and Peter Stone and Takuma Seno},
+    year   = {2024},
+    url    = {https://api.semanticscholar.org/CorpusID:273346233}
+}
+```
+
+```bibtex
+@inproceedings{anonymous2024the,
+    title   = {The Complexity Dynamics of Grokking},
+    author  = {Anonymous},
+    booktitle = {Submitted to The Thirteenth International Conference on Learning Representations},
+    year    = {2024},
+    url     = {https://openreview.net/forum?id=07N9jCfIE4},
+    note    = {under review}
+}
+```
+
+```bibtex
+@article{Yang2020LearningLD,
+    title   = {Learning Low-rank Deep Neural Networks via Singular Vector Orthogonality Regularization and Singular Value Sparsification},
+    author  = {Huanrui Yang and Minxue Tang and Wei Wen and Feng Yan and Daniel Hu and Ang Li and Hai Helen Li and Yiran Chen},
+    journal = {2020 IEEE/CVF Conference on Computer Vision and Pattern Recognition Workshops (CVPRW)},
+    year    = {2020},
+    pages   = {2899-2908},
+    url     = {https://api.semanticscholar.org/CorpusID:213940794}
+}
+```
+
+```bibtex
+@article{Farebrother2024StopRT,
+    title   = {Stop Regressing: Training Value Functions via Classification for Scalable Deep RL},
+    author  = {Jesse Farebrother and Jordi Orbay and Quan Ho Vuong and Adrien Ali Taiga and Yevgen Chebotar and Ted Xiao and Alex Irpan and Sergey Levine and Pablo Samuel Castro and Aleksandra Faust and Aviral Kumar and Rishabh Agarwal},
+    journal = {ArXiv},
+    year   = {2024},
+    volume = {abs/2403.03950},
+    url    = {https://api.semanticscholar.org/CorpusID:268253088}
+}
+```
+
+```bibtex
+@article{Lee2024AnalysisClippedCritic,
+    title   = {On Analysis of Clipped Critic Loss in Proximal Policy Gradient},
+    author  = {Yongjin Lee, Moonyoung Chung},
+    journal = {Authorea},
+    year    = {2024}
+}
+```
+
+```bibtex
+@inproceedings{Felizardo2025ARL,
+    title   = {A Reinforcement Learning Method for Environments with Stochastic Variables: Post-Decision Proximal Policy Optimization with Dual Critic Networks},
+    author  = {Leonardo Kanashiro Felizardo and Edoardo Fadda and Paolo Brandimarte and Emilio Del-Moral-Hernandez and Mari'a Cristina Vasconcelos Nascimento},
+    year    = {2025},
+    url     = {https://api.semanticscholar.org/CorpusID:277621941}
+}
+```
+
+```bibtex
+@misc{xie2025simplepolicyoptimization,
+    title   = {Simple Policy Optimization},
+    author  = {Zhengpeng Xie and Qiang Zhang and Fan Yang and Marco Hutter and Renjing Xu},
+    year    = {2025},
+    eprint  = {2401.16025},
+    archivePrefix = {arXiv},
+    primaryClass = {cs.LG},
+    url = {https://arxiv.org/abs/2401.16025},
+}
+```
+
+```bibtex
+@inproceedings{anonymous2025flow,
+    title   = {Flow Policy Gradients for Legged Robots},
+    author  = {Anonymous},
+    booktitle = {Submitted to The Fourteenth International Conference on Learning Representations},
+    year    = {2025},
+    url     = {https://openreview.net/forum?id=BA6n0nmagi},
+    note    = {under review}
+}
+```
+
+```bibtex
+@inproceedings{Seitzer2022Pitfalls,
+    title   = {On the Pitfalls of Heteroscedastic Uncertainty Estimation with Probabilistic Neural Networks},
+    author  = {Maximilian Seitzer and Abdul-Saboor Sheikh and Georg Martius},
+    booktitle = {International Conference on Learning Representations},
+    year    = {2022},
+    url     = {https://openreview.net/forum?id=9O_xF9y7A-}
+}
+```
+
+```bibtex
+@inproceedings{Wang2025EvolutionaryPO,
+    title   = {Evolutionary Policy Optimization},
+    author  = {Jianren Wang and Yifan Su and Abhinav Gupta and Deepak Pathak},
+    booktitle = {Advances in Neural Information Processing Systems},
+    year    = {2025},
+    url     = {https://arxiv.org/abs/2503.19037}
+}
+```
+
+```bibtex
+@misc{osband2026delightfulpolicygradient,
+    title   = {Delightful Policy Gradient},
+    author  = {Ian Osband},
+    year    = {2026},
+    eprint  = {2603.14608},
+    archivePrefix = {arXiv},
+    primaryClass = {cs.LG},
+    url     = {https://arxiv.org/abs/2603.14608},
+}
+```
+
+```bibtex
+@misc{eysenbach2018diversityneedlearningskills,
+    title   = {Diversity is All You Need: Learning Skills without a Reward Function},
+    author  = {Benjamin Eysenbach and Abhishek Gupta and Julian Ibarz and Sergey Levine},
+    year    = {2018},
+    eprint  = {1802.06070},
+    archivePrefix = {arXiv},
+    primaryClass = {cs.AI},
+    url     = {https://arxiv.org/abs/1802.06070},
+}
+```
+
+```bibtex
+@misc{mustafaoglu2025evolutionarypolicyoptimization,
+    title   = {Evolutionary Policy Optimization},
+    author  = {Zelal Su "Lain" Mustafaoglu and Keshav Pingali and Risto Miikkulainen},
+    year    = {2025},
+    eprint  = {2504.12568},
+    archivePrefix = {arXiv},
+    primaryClass = {cs.LG},
+    url     = {https://arxiv.org/abs/2504.12568},
+}
+```
+
+```bibtex
+@misc{han2026firefrobeniusisometryreinitializationbalancing,
+    title   = {FIRE: Frobenius-Isometry Reinitialization for Balancing the Stability-Plasticity Tradeoff},
+    author  = {Isaac Han and Sangyeon Park and Seungwon Oh and Donghu Kim and Hojoon Lee and Kyung-Joong Kim},
+    year    = {2026},
+    eprint  = {2602.08040},
+    archivePrefix = {arXiv},
+    primaryClass = {cs.LG},
+    url     = {https://arxiv.org/abs/2602.08040},
+}
+```
+
+```bibtex
+@misc{tian2026chunkingcritic,
+    title   = {Chunking the Critic: A Transformer-based Soft Actor-Critic with N-Step Returns},
+    author  = {Dong Tian and Onur Celik and Gerhard Neumann},
+    year    = {2026},
+    eprint  = {2503.03660},
+    archivePrefix = {arXiv},
+    primaryClass = {cs.LG},
+    url     = {https://arxiv.org/abs/2503.03660},
+}
+```
+
+```bibtex
+@misc{hahn2025action,
+    title   = {Action Chunking Proximal Policy Optimization for Universal Robotic Dexterous Grasping},
+    author  = {Sanghyun Hahn and Jonghyun Choi},
+    year    = {2025},
+    url     = {https://openreview.net/forum?id=WFQnqY1c39}
+}
+```
+
+```bibtex
+@misc{shin2026adaptiveactionchunkingmultichunk,
+    title   = {Adaptive Action Chunking via Multi-Chunk Q Value Estimation},
+    author  = {Yongjae Shin and Jongseong Chae and Seongmin Kim and Jongeui Park and Youngchul Sung},
+    year    = {2026},
+    eprint  = {2605.10044},
+    archivePrefix = {arXiv},
+    primaryClass = {cs.LG},
+    url     = {https://arxiv.org/abs/2605.10044},
+}
+```

x_ppo-0.0.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+x_ppo/__init__.py,sha256=Ojy4-7PYWDZuEs-nkHDlfOmxs93EWXN95B6msFfGD7g,37
+x_ppo/ppo.py,sha256=pHG8HNAAsUnX2iM-8d_Skg6e3MZeFUOFDRshc2yCFJ4,652
+x_ppo-0.0.1.dist-info/METADATA,sha256=YNnsxA3o37mj6V0jmaTUqb9KIuHi_4FmG5exnvdor5U,9704
+x_ppo-0.0.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+x_ppo-0.0.1.dist-info/licenses/LICENSE,sha256=As9u198X-U-vph5noInuUfqsAG2zX_oXPHDmdjwlPPY,1066
+x_ppo-0.0.1.dist-info/RECORD,,

x_ppo-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

x_ppo-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Phil Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.