OptiRoulette 0.1.0__tar.gz

optiroulette-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Stamatis Mastromichalakis
+
+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.

optiroulette-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include THIRD_PARTY_LICENSES.md
+recursive-include src/optiroulette/resources *.yaml

optiroulette-0.1.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: OptiRoulette
+Version: 0.1.0
+Summary: PyTorch optimizer with random switching, LR scaling and pool swaps
+Author: Stamatis Mastromichalakis
+License: MIT
+Project-URL: Homepage, https://github.com/MStamatis/OptiRoulette
+Project-URL: Repository, https://github.com/MStamatis/OptiRoulette
+Keywords: pytorch,optimizer,meta optimizer,deep-learning,training,optimization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: torch>=2.1.0
+Requires-Dist: numpy>=1.23.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: pytorch-optimizer>=3.7.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2.1; extra == "dev"
+Requires-Dist: twine>=5.1.1; extra == "dev"
+Requires-Dist: pytest>=8.2.0; extra == "dev"
+Dynamic: license-file
+
+# OptiRoulette Optimizer
+
+This repository accompanies the paper "OptiRoulette Optimizer: A New Stochastic
+Meta-Optimizer for up to 5.3x Faster Convergence".
+
+A standalone, pip-installable PyTorch meta-optimizer that brings OptiRoulette's training logic to any project:
+- random optimizer switching
+- warmup -> roulette phase handling
+- optimizer pool with active/backup swapping
+- compatibility-aware replacement
+- learning-rate scaling rules when switching
+- momentum/state transfer on swap
+
+The default behavior is loaded from the bundled `optimized.yaml` profile (same optimizer pool logic used in this project).
+
+## Research Highlights
+
+Based on the current paper draft, OptiRoulette is a stochastic meta-optimizer
+that combines:
+- warmup optimizer locking
+- randomized sampling from an active optimizer pool
+- compatibility-aware LR scaling during optimizer transitions
+- failure-aware pool replacement
+
+Reported mean test accuracy vs a single-optimizer AdamW baseline:
+
+| Dataset | AdamW | OptiRoulette | Delta |
+|---|---:|---:|---:|
+| CIFAR-100 | 0.6734 | 0.7656 | +9.22 pp |
+| CIFAR-100-C | 0.2904 | 0.3355 | +4.52 pp |
+| SVHN | 0.9667 | 0.9756 | +0.89 pp |
+| Tiny ImageNet | 0.5669 | 0.6642 | +9.73 pp |
+| Caltech-256 | 0.5946 | 0.6920 | +9.74 pp |
+
+Additional paper-reported highlights:
+- Target-hit reliability: in the reported 10-seed suites, OptiRoulette reaches
+  key validation targets in 10/10 runs, while the AdamW baseline reaches none
+  of those targets within budget.
+- Faster time-to-target on shared milestones (example: Caltech-256 @ 0.59,
+  25.7 vs 77.0 epochs), with budget-capped lower-bound speedups up to 5.3x for
+  non-attained baseline targets.
+- Paired-seed analysis is positive across datasets, except CIFAR-100-C test
+  ROC-AUC, which is not statistically significant in the current 10-seed study.
+
+## Install
+
+```bash
+pip install OptiRoulette
+```
+
+## Examples
+
+- [CIFAR-100 demo notebook](examples/quick_cifar100_optiroulette.ipynb)
+- [Tiny-ImageNet demo notebook](examples/quick_tiny_imagenet_optiroulette.ipynb)
+
+## Quick Use
+
+```python
+import torch
+from optiroulette import OptiRoulette
+
+model = torch.nn.Linear(128, 10)
+optimizer = OptiRoulette(model.parameters())
+
+for epoch in range(5):
+    optimizer.on_epoch_start(epoch)
+
+    for batch_idx in range(100):
+        optimizer.on_batch_start(batch_idx)
+        optimizer.zero_grad()
+        x = torch.randn(32, 128)
+        y = torch.randint(0, 10, (32,))
+        loss = torch.nn.functional.cross_entropy(model(x), y)
+        loss.backward()
+        optimizer.step()
+
+    # pass validation accuracy for warmup plateau logic (optional)
+    optimizer.on_epoch_end(val_acc=0.6)
+```
+
+## API
+
+```python
+from optiroulette import (
+    OptiRoulette,
+    OptiRouletteOptimizer,
+    PoolConfig,
+    get_default_config,
+    get_default_seed,
+    get_default_optimizer_specs,
+    get_default_pool_setup,
+    get_default_roulette_config,
+)
+```
+
+## Configuration Reference
+
+For a full settings guide (constructor arguments, `optimizer_specs`,
+`pool_config`, warmup/roulette options, and defaults precedence), see:
+- `docs/configuration.md`
+
+For package maintainers (release/publish steps), see:
+- `docs/release.md`
+
+### Defaults behavior
+
+`OptiRoulette(model.parameters())` uses:
+- default optimizer specs from bundled `optimized.yaml`
+- default roulette settings from bundled `optimized.yaml`
+- default pool config + active/backup names from bundled `optimized.yaml`
+- default LR scaling rules from bundled `optimized.yaml`
+- default optimizer RNG seed from bundled `optimized.yaml` (`system.seed`, fallback `42`)
+
+If you provide manual optimizer/pool settings, those are used instead of defaults:
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={"adam": {"lr": 1e-3}},
+)
+```
+
+Manual custom pool example (only your chosen optimizers are used):
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={
+        "adam": {"lr": 1e-3},
+        "adamw": {"lr": 8e-4, "weight_decay": 0.01},
+        "lion": {"lr": 1e-4, "betas": (0.9, 0.99)},
+    },
+    active_names=["adam", "adamw"],
+    backup_names=["lion"],
+)
+```
+
+Optional: override pool behavior too:
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={
+        "adam": {"lr": 1e-3},
+        "adamw": {"lr": 8e-4, "weight_decay": 0.01},
+        "lion": {"lr": 1e-4, "betas": (0.9, 0.99)},
+    },
+    pool_config={
+        "num_active": 2,
+        "num_backup": 1,
+        "failure_threshold": -0.2,
+        "consecutive_failure_limit": 3,
+    },
+    active_names=["adam", "adamw"],
+    backup_names=["lion"],
+)
+```
+
+## Third-Party Dependencies
+
+This package depends on `pytorch-optimizer` for additional optimizer implementations.
+See `THIRD_PARTY_LICENSES.md` for a short third-party license notice.
+
+## Disclaimer
+
+The OptiRoulette name refers exclusively to a machine-learning optimizer and has no
+affiliation, sponsorship, or technical relation to roulette manufacturers, casinos,
+or any physical/software gambling products or services.

optiroulette-0.1.0/README.md

@@ -0,0 +1,168 @@
+# OptiRoulette Optimizer
+
+This repository accompanies the paper "OptiRoulette Optimizer: A New Stochastic
+Meta-Optimizer for up to 5.3x Faster Convergence".
+
+A standalone, pip-installable PyTorch meta-optimizer that brings OptiRoulette's training logic to any project:
+- random optimizer switching
+- warmup -> roulette phase handling
+- optimizer pool with active/backup swapping
+- compatibility-aware replacement
+- learning-rate scaling rules when switching
+- momentum/state transfer on swap
+
+The default behavior is loaded from the bundled `optimized.yaml` profile (same optimizer pool logic used in this project).
+
+## Research Highlights
+
+Based on the current paper draft, OptiRoulette is a stochastic meta-optimizer
+that combines:
+- warmup optimizer locking
+- randomized sampling from an active optimizer pool
+- compatibility-aware LR scaling during optimizer transitions
+- failure-aware pool replacement
+
+Reported mean test accuracy vs a single-optimizer AdamW baseline:
+
+| Dataset | AdamW | OptiRoulette | Delta |
+|---|---:|---:|---:|
+| CIFAR-100 | 0.6734 | 0.7656 | +9.22 pp |
+| CIFAR-100-C | 0.2904 | 0.3355 | +4.52 pp |
+| SVHN | 0.9667 | 0.9756 | +0.89 pp |
+| Tiny ImageNet | 0.5669 | 0.6642 | +9.73 pp |
+| Caltech-256 | 0.5946 | 0.6920 | +9.74 pp |
+
+Additional paper-reported highlights:
+- Target-hit reliability: in the reported 10-seed suites, OptiRoulette reaches
+  key validation targets in 10/10 runs, while the AdamW baseline reaches none
+  of those targets within budget.
+- Faster time-to-target on shared milestones (example: Caltech-256 @ 0.59,
+  25.7 vs 77.0 epochs), with budget-capped lower-bound speedups up to 5.3x for
+  non-attained baseline targets.
+- Paired-seed analysis is positive across datasets, except CIFAR-100-C test
+  ROC-AUC, which is not statistically significant in the current 10-seed study.
+
+## Install
+
+```bash
+pip install OptiRoulette
+```
+
+## Examples
+
+- [CIFAR-100 demo notebook](examples/quick_cifar100_optiroulette.ipynb)
+- [Tiny-ImageNet demo notebook](examples/quick_tiny_imagenet_optiroulette.ipynb)
+
+## Quick Use
+
+```python
+import torch
+from optiroulette import OptiRoulette
+
+model = torch.nn.Linear(128, 10)
+optimizer = OptiRoulette(model.parameters())
+
+for epoch in range(5):
+    optimizer.on_epoch_start(epoch)
+
+    for batch_idx in range(100):
+        optimizer.on_batch_start(batch_idx)
+        optimizer.zero_grad()
+        x = torch.randn(32, 128)
+        y = torch.randint(0, 10, (32,))
+        loss = torch.nn.functional.cross_entropy(model(x), y)
+        loss.backward()
+        optimizer.step()
+
+    # pass validation accuracy for warmup plateau logic (optional)
+    optimizer.on_epoch_end(val_acc=0.6)
+```
+
+## API
+
+```python
+from optiroulette import (
+    OptiRoulette,
+    OptiRouletteOptimizer,
+    PoolConfig,
+    get_default_config,
+    get_default_seed,
+    get_default_optimizer_specs,
+    get_default_pool_setup,
+    get_default_roulette_config,
+)
+```
+
+## Configuration Reference
+
+For a full settings guide (constructor arguments, `optimizer_specs`,
+`pool_config`, warmup/roulette options, and defaults precedence), see:
+- `docs/configuration.md`
+
+For package maintainers (release/publish steps), see:
+- `docs/release.md`
+
+### Defaults behavior
+
+`OptiRoulette(model.parameters())` uses:
+- default optimizer specs from bundled `optimized.yaml`
+- default roulette settings from bundled `optimized.yaml`
+- default pool config + active/backup names from bundled `optimized.yaml`
+- default LR scaling rules from bundled `optimized.yaml`
+- default optimizer RNG seed from bundled `optimized.yaml` (`system.seed`, fallback `42`)
+
+If you provide manual optimizer/pool settings, those are used instead of defaults:
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={"adam": {"lr": 1e-3}},
+)
+```
+
+Manual custom pool example (only your chosen optimizers are used):
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={
+        "adam": {"lr": 1e-3},
+        "adamw": {"lr": 8e-4, "weight_decay": 0.01},
+        "lion": {"lr": 1e-4, "betas": (0.9, 0.99)},
+    },
+    active_names=["adam", "adamw"],
+    backup_names=["lion"],
+)
+```
+
+Optional: override pool behavior too:
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={
+        "adam": {"lr": 1e-3},
+        "adamw": {"lr": 8e-4, "weight_decay": 0.01},
+        "lion": {"lr": 1e-4, "betas": (0.9, 0.99)},
+    },
+    pool_config={
+        "num_active": 2,
+        "num_backup": 1,
+        "failure_threshold": -0.2,
+        "consecutive_failure_limit": 3,
+    },
+    active_names=["adam", "adamw"],
+    backup_names=["lion"],
+)
+```
+
+## Third-Party Dependencies
+
+This package depends on `pytorch-optimizer` for additional optimizer implementations.
+See `THIRD_PARTY_LICENSES.md` for a short third-party license notice.
+
+## Disclaimer
+
+The OptiRoulette name refers exclusively to a machine-learning optimizer and has no
+affiliation, sponsorship, or technical relation to roulette manufacturers, casinos,
+or any physical/software gambling products or services.

optiroulette-0.1.0/THIRD_PARTY_LICENSES.md

@@ -0,0 +1,15 @@
+# Third-Party Licenses
+
+This project uses the following third-party dependency:
+
+## pytorch-optimizer
+
+- Package: `pytorch-optimizer`
+- Homepage: https://github.com/kozistr/pytorch_optimizer
+- PyPI: https://pypi.org/project/pytorch-optimizer/
+- Declared license (project metadata): Apache-2.0
+
+Usage note:
+- `OptiRoulette` imports `pytorch-optimizer` as a runtime dependency to access
+  additional optimizer classes.
+

optiroulette-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "OptiRoulette"
+version = "0.1.0"
+description = "PyTorch optimizer with random switching, LR scaling and pool swaps"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name = "Stamatis Mastromichalakis" }
+]
+keywords = ["pytorch", "optimizer", "meta optimizer", "deep-learning", "training", "optimization"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+  "torch>=2.1.0",
+  "numpy>=1.23.0",
+  "PyYAML>=6.0",
+  "pytorch-optimizer>=3.7.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/MStamatis/OptiRoulette"
+Repository = "https://github.com/MStamatis/OptiRoulette"
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2.1",
+  "twine>=5.1.1",
+  "pytest>=8.2.0",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"optiroulette.resources" = ["optimized.yaml"]

optiroulette-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

optiroulette-0.1.0/src/OptiRoulette/__init__.py

@@ -0,0 +1,4 @@
+"""Compatibility alias for users importing with capitalized module name."""
+
+from optiroulette import *  # noqa: F401,F403
+

optiroulette-0.1.0/src/OptiRoulette.egg-info/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: OptiRoulette
+Version: 0.1.0
+Summary: PyTorch optimizer with random switching, LR scaling and pool swaps
+Author: Stamatis Mastromichalakis
+License: MIT
+Project-URL: Homepage, https://github.com/MStamatis/OptiRoulette
+Project-URL: Repository, https://github.com/MStamatis/OptiRoulette
+Keywords: pytorch,optimizer,meta optimizer,deep-learning,training,optimization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: torch>=2.1.0
+Requires-Dist: numpy>=1.23.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: pytorch-optimizer>=3.7.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2.1; extra == "dev"
+Requires-Dist: twine>=5.1.1; extra == "dev"
+Requires-Dist: pytest>=8.2.0; extra == "dev"
+Dynamic: license-file
+
+# OptiRoulette Optimizer
+
+This repository accompanies the paper "OptiRoulette Optimizer: A New Stochastic
+Meta-Optimizer for up to 5.3x Faster Convergence".
+
+A standalone, pip-installable PyTorch meta-optimizer that brings OptiRoulette's training logic to any project:
+- random optimizer switching
+- warmup -> roulette phase handling
+- optimizer pool with active/backup swapping
+- compatibility-aware replacement
+- learning-rate scaling rules when switching
+- momentum/state transfer on swap
+
+The default behavior is loaded from the bundled `optimized.yaml` profile (same optimizer pool logic used in this project).
+
+## Research Highlights
+
+Based on the current paper draft, OptiRoulette is a stochastic meta-optimizer
+that combines:
+- warmup optimizer locking
+- randomized sampling from an active optimizer pool
+- compatibility-aware LR scaling during optimizer transitions
+- failure-aware pool replacement
+
+Reported mean test accuracy vs a single-optimizer AdamW baseline:
+
+| Dataset | AdamW | OptiRoulette | Delta |
+|---|---:|---:|---:|
+| CIFAR-100 | 0.6734 | 0.7656 | +9.22 pp |
+| CIFAR-100-C | 0.2904 | 0.3355 | +4.52 pp |
+| SVHN | 0.9667 | 0.9756 | +0.89 pp |
+| Tiny ImageNet | 0.5669 | 0.6642 | +9.73 pp |
+| Caltech-256 | 0.5946 | 0.6920 | +9.74 pp |
+
+Additional paper-reported highlights:
+- Target-hit reliability: in the reported 10-seed suites, OptiRoulette reaches
+  key validation targets in 10/10 runs, while the AdamW baseline reaches none
+  of those targets within budget.
+- Faster time-to-target on shared milestones (example: Caltech-256 @ 0.59,
+  25.7 vs 77.0 epochs), with budget-capped lower-bound speedups up to 5.3x for
+  non-attained baseline targets.
+- Paired-seed analysis is positive across datasets, except CIFAR-100-C test
+  ROC-AUC, which is not statistically significant in the current 10-seed study.
+
+## Install
+
+```bash
+pip install OptiRoulette
+```
+
+## Examples
+
+- [CIFAR-100 demo notebook](examples/quick_cifar100_optiroulette.ipynb)
+- [Tiny-ImageNet demo notebook](examples/quick_tiny_imagenet_optiroulette.ipynb)
+
+## Quick Use
+
+```python
+import torch
+from optiroulette import OptiRoulette
+
+model = torch.nn.Linear(128, 10)
+optimizer = OptiRoulette(model.parameters())
+
+for epoch in range(5):
+    optimizer.on_epoch_start(epoch)
+
+    for batch_idx in range(100):
+        optimizer.on_batch_start(batch_idx)
+        optimizer.zero_grad()
+        x = torch.randn(32, 128)
+        y = torch.randint(0, 10, (32,))
+        loss = torch.nn.functional.cross_entropy(model(x), y)
+        loss.backward()
+        optimizer.step()
+
+    # pass validation accuracy for warmup plateau logic (optional)
+    optimizer.on_epoch_end(val_acc=0.6)
+```
+
+## API
+
+```python
+from optiroulette import (
+    OptiRoulette,
+    OptiRouletteOptimizer,
+    PoolConfig,
+    get_default_config,
+    get_default_seed,
+    get_default_optimizer_specs,
+    get_default_pool_setup,
+    get_default_roulette_config,
+)
+```
+
+## Configuration Reference
+
+For a full settings guide (constructor arguments, `optimizer_specs`,
+`pool_config`, warmup/roulette options, and defaults precedence), see:
+- `docs/configuration.md`
+
+For package maintainers (release/publish steps), see:
+- `docs/release.md`
+
+### Defaults behavior
+
+`OptiRoulette(model.parameters())` uses:
+- default optimizer specs from bundled `optimized.yaml`
+- default roulette settings from bundled `optimized.yaml`
+- default pool config + active/backup names from bundled `optimized.yaml`
+- default LR scaling rules from bundled `optimized.yaml`
+- default optimizer RNG seed from bundled `optimized.yaml` (`system.seed`, fallback `42`)
+
+If you provide manual optimizer/pool settings, those are used instead of defaults:
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={"adam": {"lr": 1e-3}},
+)
+```
+
+Manual custom pool example (only your chosen optimizers are used):
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={
+        "adam": {"lr": 1e-3},
+        "adamw": {"lr": 8e-4, "weight_decay": 0.01},
+        "lion": {"lr": 1e-4, "betas": (0.9, 0.99)},
+    },
+    active_names=["adam", "adamw"],
+    backup_names=["lion"],
+)
+```
+
+Optional: override pool behavior too:
+
+```python
+optimizer = OptiRoulette(
+    model.parameters(),
+    optimizer_specs={
+        "adam": {"lr": 1e-3},
+        "adamw": {"lr": 8e-4, "weight_decay": 0.01},
+        "lion": {"lr": 1e-4, "betas": (0.9, 0.99)},
+    },
+    pool_config={
+        "num_active": 2,
+        "num_backup": 1,
+        "failure_threshold": -0.2,
+        "consecutive_failure_limit": 3,
+    },
+    active_names=["adam", "adamw"],
+    backup_names=["lion"],
+)
+```
+
+## Third-Party Dependencies
+
+This package depends on `pytorch-optimizer` for additional optimizer implementations.
+See `THIRD_PARTY_LICENSES.md` for a short third-party license notice.
+
+## Disclaimer
+
+The OptiRoulette name refers exclusively to a machine-learning optimizer and has no
+affiliation, sponsorship, or technical relation to roulette manufacturers, casinos,
+or any physical/software gambling products or services.