umi-melee

The Universal Melee Interface (UMI): the Python library and conformance test for bots in the Computer Melee Championship, where Super Smash Bros. Melee bots play each other on equal hardware.

pip install umi-melee

A bot

import numpy as np
import umi


class MyBot(umi.Bot):
    name, characters, delay = "my-bot", "ALL", 18

    def setup(self, session):
        self.rng = np.random.default_rng()      # load your model here

    def act(self, batch):
        # batch.frames: one frame per game, from your seat: frames["players"][:, 0] is your bot
        ctrl = self.rng.random((len(batch.games), 13), dtype=np.float32)
        return umi.Actions(ctrl=ctrl)           # one controller row per game


if __name__ == "__main__":
    umi.serve(MyBot())

umi.Bot handles the protocol, batching, and padding. A model with memory also defines initial_state(n), and its act takes and returns each game's memory: act(batch, state) -> (actions, state).

Check it

umi-conform --cmd "python run.py"

It plays your bot against a built-in arena and reports anything the real one would refuse.

Enter it

Zip run.py, requirements.txt, and your weights, and upload them on the site. Entry is by invitation for now: ask through the site's contact page or in the #artificial-intelligence channel of the Slippi Discord.