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 <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 2024 as strings, you can use:
>>> get_agents(version=2024, track="oneshot", finalists_only=True, top_only=0.1, as_class=False)
Winners of the SCML 2024 Competition
====================================
Oneshot Track
-------------
* First Place: Ryoga Miyajima for **CautiousOneShotAgent**
* Second Place: Arnie He, Akash Singirikonda, and Amy Greenwald for **MatchingPennies**
* Third Place: Hajime Endo for **DistRedistAgent**
* Third Place: Yuzuru Kitamura for **EpsilonGreedyAgent**
You can get these agents after installing scml-agents by running:
>>> scml_agents.get_agents(2024, track="oneshot", winners_only=True)
Standard Track
--------------
* First Place: Gou Kazusa for **PenguinAgent**
You can get this agent after installing scml-agents by running:
>>> scml_agents.get_agents(2024, track="std", winners_only=True)
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 <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 <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 <https://developer.apple.com/metal/tensorflow-plugin/>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/yasserfarouk/scml-agents",
"name": "scml-agents",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "negotiation mas multi-agent simulation AI",
"author": "Yasser Mohammad",
"author_email": "yasserfarouk@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0b/b3/5de3d54c519a61abe043bd77ffe93f31cf7b9528c9ce0814f73cde7cf9b6/scml-agents-0.4.9.tar.gz",
"platform": null,
"description": "This repository contains agents for the SCML world.\n\nTo install this package just run:\n\n>>> pip install scml-agents\n\nThere are two ways to submit agents to this repository:\n\n1. Participate in the SCML competition `https://scml.cs.brown.edu <https://scml.cs.brown.edu>`_\n2. Submit a pull-request with your agent added to the contrib directory.\n\n\n**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.**\n\nGetting lists of agents\n=======================\n\nYou can get any specific subset of the agents in the library using `get_agents()`. This function\nhas the following parameters:\n\n* 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.\n* track: The track (any, collusion, std, sabotage[only for 2019], oneshot [from 2021]).\n* qualified_only: If true, only agents that were submitted to SCML and ran in the qualifications round will be\n returned\n* finalists_only: If true, only agents that were submitted to SCML and passed qualifications will be\n returned\n* winners_only: If true, only winners of SCML (the given version) will be returned.\n* bird_only: If true, only winners the bird award are returned (new in 2021)\n* top_only: Either a fraction of finalists or the top n finalists with highest scores in the finals of\n SCML\n* as_class: If true, the agent classes will be returned otherwise their full class names.\n\n\nFor example, to get the top 10% of the Oneshot track finalists in year 2024 as strings, you can use:\n\n>>> get_agents(version=2024, track=\"oneshot\", finalists_only=True, top_only=0.1, as_class=False)\n\nWinners of the SCML 2024 Competition\n====================================\n\nOneshot Track\n-------------\n* First Place: Ryoga Miyajima for **CautiousOneShotAgent**\n* Second Place: Arnie He, Akash Singirikonda, and Amy Greenwald for **MatchingPennies**\n* Third Place: Hajime Endo for **DistRedistAgent**\n* Third Place: Yuzuru Kitamura for **EpsilonGreedyAgent**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2024, track=\"oneshot\", winners_only=True)\n\nStandard Track\n--------------\n* First Place: Gou Kazusa for **PenguinAgent**\n\nYou can get this agent after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2024, track=\"std\", winners_only=True)\n\nWinners of the SCML 2023 Competition\n====================================\n\nOneshot Track\n-------------\n* First Place: Pedro Hrosz Turini and Jaime Sichman for **QuantityOrientedAgent**\n* Second Place: Shota Kimata and Yuko Sakurai for **CCAgent**\n* Third Place: Masato Kijima for **KanbeAgent**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2023, track=\"oneshot\", winners_only=True)\n\nStandard Track\n--------------\n* First Place: Sadahiro Atsunaga for **AgentSDH**\n\nYou can get this agent after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2023, track=\"std\", winners_only=True)\n\nCollusion Track\n---------------\n* Honorary Mention: Kazuki Komori for **M5**\n\nYou can get this agent after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2023, track=\"collusion\", winners_only=True)\n\nWinners of the SCML 2022 Competition\n====================================\n\nOneshot Track\n-------------\n* First Place: Chris Mascioli and Amy Greenwald for **PatientAgent**\n* Second Place: Takumu Shimizu for **GentleS**\n* Third Place: Shiraz Nave, Amit Dayan, Sariel Turayfor **AgentSAS**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2022, track=\"oneshot\", winners_only=True)\n\nStandard Track\n--------------\n* First Place: Ito Nobuhiro and Takanobu Otsukafor **Lobster**\n* Second Place: Kazuki Komori for **M5**\n* Third Place: Koki Katagiri and Tatanobu Otsuka for **Artisan Kangaroo**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2022, track=\"std\", winners_only=True)\n\nCollusion Track\n---------------\n* Honorary Mention: Kazuki Komori for **M5**\n\nYou can get this agent after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2022, track=\"collusion\", winners_only=True)\n\nWinners of the SCML 2021 Competition\n====================================\n\nOneshot Track\n-------------\n* First Place: Assaf Tirangel, Yossi Weizman, Inbal Avraham for **Agent112**\n* Second Place: Takumu Shimizu for **Gentle**\n* Third Place (tie): Sagi Nachum for **Agent74**\n* Third Place (tie): Yuchen Liu, Rafik Hadfi and Takayuki Ito for **UCOneshotAgent**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2021, track=\"oneshot\", winners_only=True)\n\nStandard Track\n--------------\n* First Place: Kazuki Komori for **M4**\n* Second Place: Mehmet Onur Keskin, Umit Cakan, Gevher Yesevi, Reyhan Aydogan, Amy Greenwald for **CharliesAgent**\n* Third Place: Koki Katagiri for **Artisan Kangaroo**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2021, track=\"std\", winners_only=True)\n\nCollusion Track\n---------------\n* First Place: Kazuki Komori for **M4**\n* Second Place: Mehmet Onur Keskin, Umit Cakan, Gevher Yesevi, Reyhan Aydogan, Amy Greenwald for **CharliesAgent**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2021, track=\"collusion\", winners_only=True)\n\nWinners of the SCML 2020 Competition\n====================================\n\nStandard Track\n--------------\n* First Place: Masahito Okuno for **SteadyMgr**\n* Second Place: Guy Heller, E. Gerson, I. Hen and M. Akrabi for **Agent30**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2020, track=\"std\", winners_only=True)\n\nCollusion Track\n---------------\n* First Place: Kazuki Komori for **MMM**\n* Second Place: Ayan Sengupta for **Merchant**\n\nYou can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2020, track=\"collusion\", winners_only=True)\n\n\nAgents accepted for the SCML 2022 qualifications\n================================================\n\nA list of all agents accepted for the SCML 2022 qualifications round can be found at `https://scml.cs.brown.edu/scml2022 <https://scml.cs.brown.edu/scml2022>`_\n\nAgents accepted for the SCML 2021 qualifications\n================================================\n\nA list of all agents accepted for the SCML 2021 qualifications round can be found at `https://scml.cs.brown.edu/scml2021 <https://scml.cs.brown.edu/scml2021>`_\n\n\nAgents accepted for the SCML 2020 qualifications\n================================================\n\nThis is a list of all the agents accepted for the SCML 2020 qualifications round.\n\n============= ============= ======================= ====================================================================================================\n Team Identifier Agent/Class name Team Members\n============= ============= ======================= ====================================================================================================\n a-sengupta a-sengupta Merchant Ayan Sengupta\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Past Frauds past_frauds MhiranoAgent Masanori Hirano\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 15 team_15 SteadyMgr Masahito Okuno\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 17 team_17 WhAgent Noriko Yuasa\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 18 team_18 Mercu Kazuto Kakutani\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 19 team_19 Ashgent Shuhei Aoyama\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 20 team_20 CrescentAgent Yuki Yoshimura\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 22 team_22 SavingAgent Takuma Kawamura\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n ThreadField threadfield GreedyFactoryManager2 Yuta Hosokawa\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team May team_may MMM Kazuki Komori\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 10 team_10 UnicornAgent Dolev Mutzari\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n BARgent bargent BARGentCovid19 Zacharie Cohen, O. Fogler, D. Neuman and R. Cohen\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n BIU-TH biu_th THBiu Haim Nafcha\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n agent0x111 agent0x111 ASMASH Matanya, Shmulik, Assaf\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 25 team_25 Agent30 Guy Heller, E. Gerson, I. Hen and M. Akrabi\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 29 team_29 BIUDODY Dror Levy, D. Joffe and O. Nagar\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 32 team_32 BeerAgent Benjamin Wexler\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n Team 27 team_27 AgentProjectGC Cihan Eran and Gevher Yesevi\n------------- ------------- ----------------------- ----------------------------------------------------------------------------------------------------\n MontyHall montyhall MontyHall Enrique Areyan Viqueira, E. Li, D. Silverston, A. Sridhar, J. Tsatsaros, A. Yuan and A. Greenwald\n============= ============= ======================= ====================================================================================================\n\n You can get these agents after installing scml-agents by running:\n\n>>> scml_agents.get_agents(2020, track=\"any\")\n\n\nInstallation Note\n=================\n\nIf you are on Apple M1, you will need to install tensorflow **before** installing this package on conda using the method described `here <https://developer.apple.com/metal/tensorflow-plugin/>`_\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Agents submitted to the SCML competition or contributed by the community",
"version": "0.4.9",
"project_urls": {
"Homepage": "https://github.com/yasserfarouk/scml-agents",
"homepage": "https://github.com/yasserfarouk/negmas"
},
"split_keywords": [
"negotiation",
"mas",
"multi-agent",
"simulation",
"ai"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0bb35de3d54c519a61abe043bd77ffe93f31cf7b9528c9ce0814f73cde7cf9b6",
"md5": "4becbdf3e0bf43d3844fd8546099cecc",
"sha256": "d4221476fca0eb2226f755907e97e4b1957b1daf8fb89eba6ec8695a2d07000e"
},
"downloads": -1,
"filename": "scml-agents-0.4.9.tar.gz",
"has_sig": false,
"md5_digest": "4becbdf3e0bf43d3844fd8546099cecc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 33675148,
"upload_time": "2024-05-20T09:45:38",
"upload_time_iso_8601": "2024-05-20T09:45:38.333054Z",
"url": "https://files.pythonhosted.org/packages/0b/b3/5de3d54c519a61abe043bd77ffe93f31cf7b9528c9ce0814f73cde7cf9b6/scml-agents-0.4.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-20 09:45:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yasserfarouk",
"github_project": "scml-agents",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "scml-agents"
}
JSON
