OpenSpiel: A Framework for Reinforcement Learning in Games
OpenSpiel is a collection of environments and algorithms for research in general reinforcement learning and search/planning in games. OpenSpiel supports n-player (single- and multi- agent) zero-sum, cooperative and general-sum, one-shot and sequential, strictly turn-taking and simultaneous-move, perfect and imperfect information games, as well as traditional multiagent environments such as (partially- and fully- observable) grid worlds and social dilemmas. OpenSpiel also includes tools to analyze learning dynamics and other common evaluation metrics. Games are represented as procedural extensive-form games, with some natural extensions. The core API and games are implemented in C++ and exposed to Python. Algorithms and tools are written both in C++ and Python.
To try OpenSpiel in Google Colaboratory, please refer to open_spiel/colabs subdirectory or start here.
Index
Please choose among the following options:
- Installing OpenSpiel (for Linux and MacOS; see separate Windows Installation instructions.)
- Introduction to OpenSpiel
- API Overview and First Example
- API Reference
- Overview of Implemented Games
- Overview of Implemented Algorithms
- Developer Guide
- Using OpenSpiel as a C++ Library
- Guidelines and Contributing
- Authors
For a longer introduction to the core concepts, formalisms, and terminology, including an overview of the algorithms and some results, please see OpenSpiel: A Framework for Reinforcement Learning in Games.
For an overview of OpenSpiel and example uses of the core API, please check out our tutorials:
- Motivation, Core API, Brief Intro to Replictor Dynamics and Imperfect Information Games by Marc Lanctot. (slides) (colab)
- Motivation, Core API, Implementing CFR and REINFORCE on Kuhn poker, Leduc poker, and Goofspiel by Edward Lockhart. (slides) (colab)
If you use OpenSpiel in your research, please cite the paper using the following BibTeX:
@article{LanctotEtAl2019OpenSpiel,
title = {{OpenSpiel}: A Framework for Reinforcement Learning in Games},
author = {Marc Lanctot and Edward Lockhart and Jean-Baptiste Lespiau and
Vinicius Zambaldi and Satyaki Upadhyay and Julien P\'{e}rolat and
Sriram Srinivasan and Finbarr Timbers and Karl Tuyls and
Shayegan Omidshafiei and Daniel Hennes and Dustin Morrill and
Paul Muller and Timo Ewalds and Ryan Faulkner and J\'{a}nos Kram\'{a}r
and Bart De Vylder and Brennan Saeta and James Bradbury and David Ding
and Sebastian Borgeaud and Matthew Lai and Julian Schrittwieser and
Thomas Anthony and Edward Hughes and Ivo Danihelka and Jonah Ryan-Davis},
year = {2019},
eprint = {1908.09453},
archivePrefix = {arXiv},
primaryClass = {cs.LG},
journal = {CoRR},
volume = {abs/1908.09453},
url = {http://arxiv.org/abs/1908.09453},
}
Versioning
We use Semantic Versioning.
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file open_spiel-2.0.2.tar.gz.
File metadata
- Download URL: open_spiel-2.0.2.tar.gz
- Upload date:
- Size: 5.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6f520dfe499b9e5e1e3a31cf77bf071abb02b98104789e7698021922a064e856
|
|
| MD5 |
4116a1441fc709acd399b1d9902c4232
|
|
| BLAKE2b-256 |
bb3b9d56d511eff27e26714aa232c945bb00335f792bc1959637ee0d2639a018
|
File details
Details for the file open_spiel-2.0.2-cp314-cp314-win_amd64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp314-cp314-win_amd64.whl
- Upload date:
- Size: 10.5 MB
- Tags: CPython 3.14, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
38ee96134315e2bd93bcf3bec7ea7f16079d4a5635523b9500e9fb853eff8eaa
|
|
| MD5 |
67038ee96e60093c3da4c8bec403ccdf
|
|
| BLAKE2b-256 |
63cac10349d4fc3644c35c43f43a68a0ef538510bbab4a3eaf1055abaa8f9fa2
|
File details
Details for the file open_spiel-2.0.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 16.1 MB
- Tags: CPython 3.14, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
661cc7615d3a09294fbc37cb9d15b123d03b970dbfc0b110ccbbc91c2835d4d2
|
|
| MD5 |
a31f33ee566f3900c7d1b97fe45ce99d
|
|
| BLAKE2b-256 |
08bff803566a00124a3d82eb056cd83442d2f8ef4ff61163f56d548481da87be
|
File details
Details for the file open_spiel-2.0.2-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
- Upload date:
- Size: 15.3 MB
- Tags: CPython 3.14, manylinux: glibc 2.27+ ARM64, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b66f2ecfec2eda81c17659b544ec2a6a729a34d54474edd09af386bad37e019b
|
|
| MD5 |
80a96362791662ddf003b0e5e474ddf8
|
|
| BLAKE2b-256 |
43112235fb7b26ac3d0dfe14437af97531c134a3b3e7e2947b88862fc181ba9d
|
File details
Details for the file open_spiel-2.0.2-cp314-cp314-macosx_11_0_arm64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp314-cp314-macosx_11_0_arm64.whl
- Upload date:
- Size: 12.4 MB
- Tags: CPython 3.14, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8c3fc8a28e0e2421f34f00cda54c9f00edfa4627c5107c88c9b750b95525902f
|
|
| MD5 |
65f0a7d49405eb77b2329ca1571aab29
|
|
| BLAKE2b-256 |
a4f4c5b892d14e106203cadfe9927ac3c2d4d72a1394f1e45f1ac1c856346e38
|
File details
Details for the file open_spiel-2.0.2-cp313-cp313-win_amd64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp313-cp313-win_amd64.whl
- Upload date:
- Size: 10.4 MB
- Tags: CPython 3.13, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bfa52822f309379bbdc8820bafa5bceee7a3e882efecba58ff65e3b8a807672b
|
|
| MD5 |
d8f68e277d298cf81a028a72c069d6e7
|
|
| BLAKE2b-256 |
d0cb5404d9773cc08394e01f0fb33c0842aa6f30c986490d38446ae277411bb4
|
File details
Details for the file open_spiel-2.0.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 16.0 MB
- Tags: CPython 3.13, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5495b58e0bb82d196b2f457b0620ad2d9e6fa9620cb881d44d31640bd9677a57
|
|
| MD5 |
f15a428b22f8d8fbf0e55d996e9a3163
|
|
| BLAKE2b-256 |
bf5389c6f4f6db6c41680794760528e3dac0b5e73cc1e3d03915eb8e803365c2
|
File details
Details for the file open_spiel-2.0.2-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
- Upload date:
- Size: 15.3 MB
- Tags: CPython 3.13, manylinux: glibc 2.27+ ARM64, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
edce4e7090c0a4162ee23eb922f4160dfab71286ac2f9a4608d80bab02804d61
|
|
| MD5 |
4cdd820a51b9792c6eb2249f27fc848f
|
|
| BLAKE2b-256 |
9875675e4a71b92474689f3c3e54d17d61fb61040477f838112cf115324d2008
|
File details
Details for the file open_spiel-2.0.2-cp313-cp313-macosx_11_0_arm64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp313-cp313-macosx_11_0_arm64.whl
- Upload date:
- Size: 12.9 MB
- Tags: CPython 3.13, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
57bd99505d28c1582c8acca5560222f157fdbed1fdf36b4a02423a4974bf035a
|
|
| MD5 |
c39c3e00ef49c96fdbe4d26145cf506c
|
|
| BLAKE2b-256 |
e3d2949be4b9551916c06d9936eec3f1ac6d220f1b760cff535277934b8f8e45
|
File details
Details for the file open_spiel-2.0.2-cp312-cp312-win_amd64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp312-cp312-win_amd64.whl
- Upload date:
- Size: 10.4 MB
- Tags: CPython 3.12, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4f8829868ba06563d53ce6bdc8fe6ff629fffa0a036cf7685a563c3a7e8f28ba
|
|
| MD5 |
ce923c80c0575bbe7e5a314fad1fef4d
|
|
| BLAKE2b-256 |
74939cb7a613a71fed7f50ab13c625e29ba297e9d48500477ec8e5c0e50536a7
|
File details
Details for the file open_spiel-2.0.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 16.0 MB
- Tags: CPython 3.12, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
73532021e2990595157e58bc7b744b1997ba705ecf21bf1d5474b51d10196318
|
|
| MD5 |
c32b65bc2ccfd1362b2c4211c79517b2
|
|
| BLAKE2b-256 |
5848bc792b2fbe2ca5603a442938a80ec127cfe42b00527276f06caba937b2a4
|
File details
Details for the file open_spiel-2.0.2-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
- Upload date:
- Size: 15.3 MB
- Tags: CPython 3.12, manylinux: glibc 2.27+ ARM64, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
608681f6bd72ba38d312aec2c52dd108f10ecc0e18bd09e4dec7528eb1e89e91
|
|
| MD5 |
4dd2b253ee53c7d1019aed7f847cad28
|
|
| BLAKE2b-256 |
eb9400f0305a51aad7a29a0cf438f30d902fc7f2a3139c662cf912c502531b58
|
File details
Details for the file open_spiel-2.0.2-cp312-cp312-macosx_11_0_arm64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp312-cp312-macosx_11_0_arm64.whl
- Upload date:
- Size: 12.9 MB
- Tags: CPython 3.12, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
648e0a998ee99ae74f2b6f176cb492e9966da0e9df6655f06c8ec003b39996af
|
|
| MD5 |
acbac6c791260837386014851fd1cf54
|
|
| BLAKE2b-256 |
0a6bd1d254b77fda4f164af35639867c1caf51dcf002f114c72515d179ab8a57
|
File details
Details for the file open_spiel-2.0.2-cp311-cp311-win_amd64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp311-cp311-win_amd64.whl
- Upload date:
- Size: 10.4 MB
- Tags: CPython 3.11, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d9ad97d7590f1e4504cf23b8fefbcc4cd00065cd2bb627550b2fdfa72fbd1783
|
|
| MD5 |
c68b4284789749a1fddfb0465cd64a49
|
|
| BLAKE2b-256 |
bb94b41975a99f02bb3d0c1d358d9253bd07e42d5bed226eb2c3d34bef582a5f
|
File details
Details for the file open_spiel-2.0.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 16.0 MB
- Tags: CPython 3.11, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
21f2d582e423ee2f5c8eb2119f84f8a236c04e243dce5a31be56e2a36634c92a
|
|
| MD5 |
70a5ded37507843576a6e9553c28e4d1
|
|
| BLAKE2b-256 |
0780718da6c15af37f04794612c03d934aaf6177b924fdab7798f5c239f039e2
|
File details
Details for the file open_spiel-2.0.2-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
- Upload date:
- Size: 15.2 MB
- Tags: CPython 3.11, manylinux: glibc 2.27+ ARM64, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69ff1b3fe3d16bb45c24aa2c017a1a5e734b7f65c6611d4e3eac9b250f69cfa0
|
|
| MD5 |
bfb7e1dab414c82680cbb2be1eebd3a6
|
|
| BLAKE2b-256 |
c0faaa757314d76ac3c4fbf8fcddc07807046a98de6dbbb197150844fec1ba79
|
File details
Details for the file open_spiel-2.0.2-cp311-cp311-macosx_11_0_arm64.whl.
File metadata
- Download URL: open_spiel-2.0.2-cp311-cp311-macosx_11_0_arm64.whl
- Upload date:
- Size: 12.9 MB
- Tags: CPython 3.11, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
765689e3b838b202349cb8db044b31fe05c0e7a23f0004fab3c3e399d8c276f4
|
|
| MD5 |
d471f5bcf1b33186019945b4de74fa85
|
|
| BLAKE2b-256 |
1be79ca0ef8ccfd9344976e869275a243c31d9f08daeba2758c4c8019c304286
|
