Update README.md
Browse files
README.md
CHANGED
|
@@ -1,6 +1,5 @@
|
|
| 1 |
---
|
| 2 |
datasets:
|
| 3 |
-
- jakegrigsby/metamon-synthetic
|
| 4 |
- jakegrigsby/metamon-parsed-replays
|
| 5 |
license: apache-2.0
|
| 6 |
pipeline_tag: reinforcement-learning
|
|
@@ -12,34 +11,16 @@ tags:
|
|
| 12 |
- transformers
|
| 13 |
---
|
| 14 |
|
| 15 |
-
|
|
|
|
|
|
|
| 16 |
|
| 17 |
-
|
| 18 |
-
|
| 19 |
-
1) A standardized suite of teams and opponents for evaluation.
|
| 20 |
-
2) A large dataset of RL trajectories "reconstructed" from real human battles.
|
| 21 |
-
3) Starting points for training imitation learning (IL) and RL policies.
|
| 22 |
-
|
| 23 |
-
Metamon is the codebase behind ["Human-Level Competitive Pokémon via Scalable Offline RL and Transformers"](https://arxiv.org/abs/2504.04395) (RLC, 2025). Please check out our [project website](https://metamon.tech) for an overview of our results. This README documents the dataset, pretrained models, training, and evaluation details to help you get battling!
|
| 24 |
|
| 25 |
**Paper:** [Human-Level Competitive Pokémon via Scalable Offline Reinforcement Learning with Transformers](https://huggingface.co/papers/2504.04395)
|
| 26 |
-
**Project Website:** https://metamon.tech
|
| 27 |
-
**Code:** [GitHub Repository](https://github.com/UT-Austin-RPL/metamon/tree/main)
|
| 28 |
-
|
| 29 |
-
### Usage
|
| 30 |
|
| 31 |
-
|
| 32 |
-
|
| 33 |
-
Load and run pretrained models with `metamon.rl.eval_pretrained`. For example, to run the default checkpoint of the `SyntheticRLV2` model for 100 battles against a set of heuristic baselines:
|
| 34 |
-
|
| 35 |
-
```bash
|
| 36 |
-
python -m metamon.rl.eval_pretrained --agent SyntheticRLV2 --gens 1 --formats ou --n_challenges 100 --eval_type heuristic
|
| 37 |
-
```
|
| 38 |
-
|
| 39 |
-
To battle against other models or humans online (via a local Showdown server):
|
| 40 |
|
| 41 |
-
|
| 42 |
-
python -m metamon.rl.eval_pretrained --agent SyntheticRLV2 --gens 1 --formats ou --n_challenges 50 --eval_type ladder --username <pick unique username> --team_set competitive
|
| 43 |
-
```
|
| 44 |
|
| 45 |
For more details on models and usage, please refer to the [project's GitHub repository](https://github.com/UT-Austin-RPL/metamon/tree/main).
|
|
|
|
| 1 |
---
|
| 2 |
datasets:
|
|
|
|
| 3 |
- jakegrigsby/metamon-parsed-replays
|
| 4 |
license: apache-2.0
|
| 5 |
pipeline_tag: reinforcement-learning
|
|
|
|
| 11 |
- transformers
|
| 12 |
---
|
| 13 |
|
| 14 |
+
<div align="center">
|
| 15 |
+
<img src="https://cdn-uploads.huggingface.co/production/uploads/6671b3decda5ebe22f2f058e/Vcq4b5M0YCUNQr_tWRPrj.png" alt="Metamon Banner" width="720">
|
| 16 |
+
</div>
|
| 17 |
|
| 18 |
+
Metamon training checkpoints for policies that play Pokémon Showdown at a human level.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 19 |
|
| 20 |
**Paper:** [Human-Level Competitive Pokémon via Scalable Offline Reinforcement Learning with Transformers](https://huggingface.co/papers/2504.04395)
|
|
|
|
|
|
|
|
|
|
|
|
|
| 21 |
|
| 22 |
+
**Project Website:** https://metamon.tech
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 23 |
|
| 24 |
+
**Code:** [GitHub Repository](https://github.com/UT-Austin-RPL/metamon/tree/main)
|
|
|
|
|
|
|
| 25 |
|
| 26 |
For more details on models and usage, please refer to the [project's GitHub repository](https://github.com/UT-Austin-RPL/metamon/tree/main).
|