yasserfarouk / scml-agents

Contributed Agents for the SCML competition

This repository contains agents for the SCML world.

To install this package just run:

>>> pip install scml-agents

There are two ways to submit agents to this repository:

1. Participate in the SCML competition https://scml.cs.brown.edu
2. Submit a pull-request with your agent added to the contrib directory.

Please note that torch does not yet fully support python 3.11. If you face issues installing (especially on a mac), try to use Python 3.10.

Getting lists of agents

You can get any specific subset of the agents in the library using get_agents(). This function has the following parameters:

• version: Either a competition year (2019, 2020, 2021, ....) or the value "contrib" for all other agents. You can also pass "all" or "any" to get all agents.
• track: The track (any, collusion, std, sabotage[only for 2019], oneshot [from 2021]).

• qualified_only: If true, only agents that were submitted to SCML and ran in the qualifications round will be

  returned

• finalists_only: If true, only agents that were submitted to SCML and passed qualifications will be

  returned

• winners_only: If true, only winners of SCML (the given version) will be returned.
• bird_only: If true, only winners the bird award are returned (new in 2021)

• top_only: Either a fraction of finalists or the top n finalists with highest scores in the finals of

  SCML

• as_class: If true, the agent classes will be returned otherwise their full class names.

For example, to get the top 10% of the Oneshot track finalists in year 2023 as strings, you can use:

>>> get_agents(version=2023, track="oneshot", finalists_only=True, top_only=0.1, as_class=False)

Winners of the SCML 2023 Competition

Oneshot Track

• First Place: Pedro Hrosz Turini and Jaime Sichman for QuantityOrientedAgent
• Second Place: Shota Kimata and Yuko Sakurai for CCAgent
• Third Place: Masato Kijima for KanbeAgent

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2023, track="oneshot", winners_only=True)

Standard Track

• First Place: Sadahiro Atsunaga for AgentSDH

You can get this agent after installing scml-agents by running:

>>> scml_agents.get_agents(2023, track="std", winners_only=True)

Collusion Track

• Honorary Mention: Kazuki Komori for M5

You can get this agent after installing scml-agents by running:

>>> scml_agents.get_agents(2023, track="collusion", winners_only=True)

Winners of the SCML 2022 Competition

Oneshot Track

• First Place: Chris Mascioli and Amy Greenwald for PatientAgent
• Second Place: Takumu Shimizu for GentleS
• Third Place: Shiraz Nave, Amit Dayan, Sariel Turayfor AgentSAS

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2022, track="oneshot", winners_only=True)

Standard Track

• First Place: Ito Nobuhiro and Takanobu Otsukafor Lobster
• Second Place: Kazuki Komori for M5
• Third Place: Koki Katagiri and Tatanobu Otsuka for Artisan Kangaroo

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2022, track="std", winners_only=True)

Collusion Track

• Honorary Mention: Kazuki Komori for M5

You can get this agent after installing scml-agents by running:

>>> scml_agents.get_agents(2022, track="collusion", winners_only=True)

Winners of the SCML 2021 Competition

Oneshot Track

• First Place: Assaf Tirangel, Yossi Weizman, Inbal Avraham for Agent112
• Second Place: Takumu Shimizu for Gentle
• Third Place (tie): Sagi Nachum for Agent74
• Third Place (tie): Yuchen Liu, Rafik Hadfi and Takayuki Ito for UCOneshotAgent

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2021, track="oneshot", winners_only=True)

Standard Track

• First Place: Kazuki Komori for M4
• Second Place: Mehmet Onur Keskin, Umit Cakan, Gevher Yesevi, Reyhan Aydogan, Amy Greenwald for CharliesAgent
• Third Place: Koki Katagiri for Artisan Kangaroo

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2021, track="std", winners_only=True)

Collusion Track

• First Place: Kazuki Komori for M4
• Second Place: Mehmet Onur Keskin, Umit Cakan, Gevher Yesevi, Reyhan Aydogan, Amy Greenwald for CharliesAgent

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2021, track="collusion", winners_only=True)

Winners of the SCML 2020 Competition

Standard Track

• First Place: Masahito Okuno for SteadyMgr
• Second Place: Guy Heller, E. Gerson, I. Hen and M. Akrabi for Agent30

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2020, track="std", winners_only=True)

Collusion Track

• First Place: Kazuki Komori for MMM
• Second Place: Ayan Sengupta for Merchant

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2020, track="collusion", winners_only=True)

Agents accepted for the SCML 2022 qualifications

A list of all agents accepted for the SCML 2022 qualifications round can be found at https://scml.cs.brown.edu/scml2022

Agents accepted for the SCML 2021 qualifications

A list of all agents accepted for the SCML 2021 qualifications round can be found at https://scml.cs.brown.edu/scml2021

Agents accepted for the SCML 2020 qualifications

This is a list of all the agents accepted for the SCML 2020 qualifications round.

Team	Identifier	Agent/Class name	Team Members
a-sengupta	a-sengupta	Merchant	Ayan Sengupta
Past Frauds	past_frauds	MhiranoAgent	Masanori Hirano
Team 15	team_15	SteadyMgr	Masahito Okuno
Team 17	team_17	WhAgent	Noriko Yuasa
Team 18	team_18	Mercu	Kazuto Kakutani
Team 19	team_19	Ashgent	Shuhei Aoyama
Team 20	team_20	CrescentAgent	Yuki Yoshimura
Team 22	team_22	SavingAgent	Takuma Kawamura
ThreadField	threadfield	GreedyFactoryManager2	Yuta Hosokawa
Team May	team_may	MMM	Kazuki Komori
Team 10	team_10	UnicornAgent	Dolev Mutzari
BARgent	bargent	BARGentCovid19	Zacharie Cohen, O. Fogler, D. Neuman and R. Cohen
BIU-TH	biu_th	THBiu	Haim Nafcha
agent0x111	agent0x111	ASMASH	Matanya, Shmulik, Assaf
Team 25	team_25	Agent30	Guy Heller, E. Gerson, I. Hen and M. Akrabi
Team 29	team_29	BIUDODY	Dror Levy, D. Joffe and O. Nagar
Team 32	team_32	BeerAgent	Benjamin Wexler
Team 27	team_27	AgentProjectGC	Cihan Eran and Gevher Yesevi
MontyHall	montyhall	MontyHall	Enrique Areyan Viqueira, E. Li, D. Silverston, A. Sridhar, J. Tsatsaros, A. Yuan and A. Greenwald

You can get these agents after installing scml-agents by running:

>>> scml_agents.get_agents(2020, track="any")

Installation Note

If you are on Apple M1, you will need to install tensorflow before installing this package on conda using the method described here