-
Notifications
You must be signed in to change notification settings - Fork 93
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Alex Rutherford
authored and
Alex Rutherford
committed
Nov 25, 2024
1 parent
18a1027
commit 38f9d77
Showing
3 changed files
with
66 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -10,7 +10,6 @@ __pycache__/ | |
docker/* | ||
*.pickle | ||
results/ | ||
docs/ | ||
tmp/ | ||
*-checkpoint.py | ||
wandb/ | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
# Welcome to JaxMARL! | ||
|
||
|
||
<div class="collage"> | ||
<div class="column" align="centre"> | ||
<div class="row" align="centre"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/cramped_room.gif?raw=true" alt="Overcooked" width="20%"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/mabrax.png?raw=true" alt="mabrax" width="20%"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/storm.gif?raw=true" alt="STORM" width="20%"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/hanabi.png?raw=true" alt="hanabi" width="20%"> | ||
</div> | ||
<div class="row" align="centre"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/coin_game.png?raw=true" alt="coin_game" width="20%"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/qmix_MPE_simple_tag_v3.gif?raw=true" alt="MPE" width="20%"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/jaxnav-ma.gif?raw=true" alt="jaxnav" width="20%"> | ||
<img src="https://github.com/FLAIROx/JaxMARL/blob/main/docs/imgs/smax.gif?raw=true" alt="SMAX" width="20%"> | ||
</div> | ||
</div> | ||
</div> | ||
|
||
_MARL but really really fast!_ | ||
|
||
JaxMARL combines ease-of-use with GPU-enabled efficiency, and supports a wide range of commonly used MARL environments as well as popular baseline algorithms. Our aim is for one library that enables thorough evaluation of MARL methods across a wide range of tasks and against relevant baselines. We also introduce SMAX, a vectorised, simplified version of the popular StarCraft Multi-Agent Challenge, which removes the need to run the StarCraft II game engine. | ||
|
||
# What we provide: | ||
* 9 MARL environments fully implemented in JAX | ||
* 8 MARL algorithms, also fully implemented in JAX | ||
|
||
|
||
## Commands | ||
|
||
* `mkdocs new [dir-name]` - Create a new project. | ||
* `mkdocs serve` - Start the live-reloading docs server. | ||
* `mkdocs build` - Build the documentation site. | ||
* `mkdocs -h` - Print help message and exit. | ||
|
||
## Project layout | ||
|
||
mkdocs.yml # The configuration file. | ||
docs/ | ||
index.md # The documentation homepage. | ||
... # Other markdown pages, images and other files. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
site_name: JaxMARL Documentation | ||
site_url: https://sitename.example | ||
theme: | ||
name: material | ||
palette: | ||
# Dark Mode | ||
- scheme: slate | ||
toggle: | ||
icon: material/weather-sunny | ||
name: Dark mode | ||
primary: green | ||
accent: deep purple | ||
|
||
# Light Mode | ||
- scheme: default | ||
toggle: | ||
icon: material/weather-night | ||
name: Light mode | ||
primary: blue | ||
accent: deep orange | ||
|
||
plugins: | ||
- search | ||
- mkdocstrings |