# README

This supplementary material contains anonymized code that implements and runs QFIX methods, based on pymarl2 and jaxmarl respectively


## Pymarl2

This code is based on a fork from the pymarl2 repository (https://github.com/benellis3/pymarl2).

To run the evaluation, do not use the `run` scripts from the repositry root.
Instead, follow these steps:

1. (optional) edit `source-this.sh` to set the path where you want to install StarCraftIII.
2. run `install-sc2.sh` to install StarCraftIII and additional maps.
3. set up a python environment as preferred, and run `install-python-dependencies.sh`.
4. set up the wandb entity and project accordingly by editing `qfix-scripts/configs/setup.use-wandb.toml`.
5. from the repository root, run `./qfix-scripts/run-iclr.sh` to run the main evaluation, and `./qfix-scripts/run-iclr-ablation.sh` to run the ablation evaluation.


## JaxMARL

This code is based on a fork from the JaxMARL repository (https://github.com/FLAIROx/JaxMARL).

To run the evaluation for our submission, you should first set up the docker container as instrusted by the repository readme.
Then, you should set up the wandb entity and project by editing the corresponding fields in `qfix-scripts/run-overcooked.iclr.sh`.
Finally, enter the docker container using `make run`, and from the repository root, run `./qfix-scripts/run-overcooked.iclr.sh`.
