Merge pull request #127 from automl/joss_paper

Merge JOSS paper branch: paper sources, DOI badge, and published citation

Author: amsks

.github/workflows/draft-pdf.yml

@@ -0,0 +1,24 @@
+name: Draft PDF
+on: [push]
+
+jobs:
+  paper:
+    runs-on: ubuntu-latest
+    name: Paper Draft
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Build draft PDF
+        uses: openjournals/openjournals-draft-action@master
+        with:
+          journal: joss
+          # This should be the path to the paper within your repo.
+          paper-path: paper/paper.md
+      - name: Upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: paper
+          # This is the output path where Pandoc will write the compiled
+          # PDF. Note, this should be the same directory as the input
+          # paper.md
+          path: paper/paper.pdf

CITATION.cff

@@ -0,0 +1,56 @@
+cff-version: "1.2.0"
+authors:
+- family-names: Mohan
+  given-names: Aditya
+  orcid: "https://orcid.org/0000-0003-0092-3780"
+- family-names: Eimer
+  given-names: Theresa
+  orcid: "https://orcid.org/0000-0001-5561-5908"
+- family-names: Benjamins
+  given-names: Carolin
+  orcid: "https://orcid.org/0009-0007-4643-3564"
+- family-names: Lindauer
+  given-names: Marius
+  orcid: "https://orcid.org/0000-0002-9675-3175"
+- family-names: Biedenkapp
+  given-names: André
+  orcid: "https://orcid.org/0000-0002-8703-8559"
+contact:
+- family-names: Mohan
+  given-names: Aditya
+  orcid: "https://orcid.org/0000-0003-0092-3780"
+doi: 10.5281/zenodo.21329992
+message: If you use this software, please cite our article in the
+  Journal of Open Source Software.
+preferred-citation:
+  authors:
+  - family-names: Mohan
+    given-names: Aditya
+    orcid: "https://orcid.org/0000-0003-0092-3780"
+  - family-names: Eimer
+    given-names: Theresa
+    orcid: "https://orcid.org/0000-0001-5561-5908"
+  - family-names: Benjamins
+    given-names: Carolin
+    orcid: "https://orcid.org/0009-0007-4643-3564"
+  - family-names: Lindauer
+    given-names: Marius
+    orcid: "https://orcid.org/0000-0002-9675-3175"
+  - family-names: Biedenkapp
+    given-names: André
+    orcid: "https://orcid.org/0000-0002-8703-8559"
+  date-published: 2026-07-28
+  doi: 10.21105/joss.10439
+  issn: 2475-9066
+  issue: 123
+  journal: Journal of Open Source Software
+  publisher:
+    name: Open Journals
+  start: 10439
+  title: "Mighty: A Comprehensive Tool for Studying Generalization,
+    Meta-RL and AutoRL"
+  type: article
+  url: "https://joss.theoj.org/papers/10.21105/joss.10439"
+  volume: 11
+title: "Mighty: A Comprehensive Tool for Studying Generalization,
+  Meta-RL and AutoRL"

README.md

@@ -11,6 +11,7 @@
 ![License](https://img.shields.io/badge/License-BSD3-orange)
 [![Test](https://github.com/automl/Mighty/actions/workflows/test.yaml/badge.svg)](https://github.com/automl/Mighty/actions/workflows/test.yaml)
 [![Doc Status](https://github.com/automl/Mighty/actions/workflows/docs_test.yaml/badge.svg)](https://github.com/automl/Mighty/actions/workflows/docs_test.yaml)
+[![DOI](https://joss.theoj.org/papers/10.21105/joss.10439/status.svg)](https://doi.org/10.21105/joss.10439)
 
 </div>
 
@@ -28,7 +29,7 @@
 # Mighty
 
 Welcome to Mighty, hopefully your future one-stop shop for everything cRL.
-Currently Mighty is still in its early stages with support for normal gym envs, DACBench and CARL.
+Mighty supports standard Gymnasium environments as well as DACBench and CARL for contextual RL.
 The interface is controlled through hydra and we provide DQN, PPO and SAC algorithms.
 We log training and regular evaluations to file and optionally also to wandb.
 If you have any questions or feedback, please tell us, ideally via the GitHub issues!
@@ -177,15 +178,29 @@ Mighty is meant to be a platform to build upon and not a large collection of met
 - **Meta Components**: RND, NovelD, SPaCE, PLR
 - **Runners**: online RL runner, ES runner
 
+## Contributions
+
+- **Aditya Mohan:** Implemented the core agent stack (training loop, model interfaces, evaluation tools), ran the experiments and evaluation, and maintained the codebase, including integration of new modules and cross-component consistency.
+- **Theresa Eimer:** Designed the system architecture, Built the environment interfaces and data pipelines, contributed to architectural decisions, and implemented the meta-learning components and their evaluation setups.
+- **Carolin Benjamins:** Reviewed the architecture, conducted focused code audits, and improved interface design and modular structure.
+- **Marius Lindauer:** Guided the overall research direction, supervised the project, and refined the methodological setup.
+- **André Biedenkapp:** Provided project supervision, contributed to research design, and advised on algorithmic methodology and experimentation.
+
 ## Cite Us
 
-If you use Mighty in your work, please cite us:
+If you use Mighty in your work, please cite our JOSS paper:
 
 ```bibtex
-@misc{mohaneimer24,
-  author    = {A. Mohan and T. Eimer and C. Benjamins and M. Lindauer and A. Biedenkapp},
-  title     = {Mighty},
-  year      = {2024},
-  url = {https://github.com/automl/mighty}
+@article{mohan2026mighty,
+  author    = {Aditya Mohan and Theresa Eimer and Carolin Benjamins and Marius Lindauer and Andr\'{e} Biedenkapp},
+  title     = {Mighty: A Comprehensive Tool for Studying Generalization, Meta-RL and AutoRL},
+  journal   = {Journal of Open Source Software},
+  year      = {2026},
+  volume    = {11},
+  number    = {123},
+  pages     = {10439},
+  publisher = {The Open Journal},
+  doi       = {10.21105/joss.10439},
+  url       = {https://doi.org/10.21105/joss.10439}
 }
 ```

docs/index.md

@@ -71,18 +71,24 @@ mindmap
 
 ### Where Is Mighty Going?
 
-Mighty currently supports DQN, PPO, and SAC with a range of contextual RL benchmarks and evaluation mechanisms. Future work will deepen support for Meta-RL and AutoRL — stay tuned.
+Mighty currently supports DQN, PPO, and SAC with a range of contextual RL benchmarks and evaluation mechanisms. Future work will deepen support for Meta-RL and AutoRL.
 
 ### Contact & Citation
 Mighty is developed at [LUHAI Hannover]() by members of [AutoRL.org](). Your first contact is lead maintainer [Aditya Mohan](). If you found issues or want to contribute new features, it's best to visit our [GitHub page](https://github.com/automl/Mighty) page and start a discussion.
 
-If you use Mighty for your research, please cite us:
+If you use Mighty for your research, please cite our JOSS paper:
 
 ```bibtex
-@misc{mohaneimer24,
-  author    = {A. Mohan and T. Eimer and C. Benjamins and M. Lindauer and A. Biedenkapp},
-  title     = {Mighty},
-  year      = {2024},
-  url = {https://github.com/automl/mighty}
+@article{mohan2026mighty,
+  author    = {Aditya Mohan and Theresa Eimer and Carolin Benjamins and Marius Lindauer and Andr\'{e} Biedenkapp},
+  title     = {Mighty: A Comprehensive Tool for Studying Generalization, Meta-RL and AutoRL},
+  journal   = {Journal of Open Source Software},
+  year      = {2026},
+  volume    = {11},
+  number    = {123},
+  pages     = {10439},
+  publisher = {The Open Journal},
+  doi       = {10.21105/joss.10439},
+  url       = {https://doi.org/10.21105/joss.10439}
 }
 ```