gamesman-nova
| Crates.io | gamesman-nova |
| lib.rs | gamesman-nova |
| version | 0.1.5 |
| source | src |
| created_at | 2023-11-09 09:02:14.458212 |
| updated_at | 2023-12-19 18:27:00.134961 |
| description | System for computing the solution set of finite, deterministic, complete-information, abstract-strategy games. |
| homepage | |
| repository | https://github.com/GamesCrafters/GamesmanNova |
| max_upload_size | |
| id | 1029959 |
| size | 156,746 |
Max Fierro (maxfierrog)
documentation
README
Nova
This is a re-focused spinoff of Dr. Dan Garcia's GamesmanClassic, a system for strongly solving (takes a deep breath) complete-information turn-based deterministic abstract strategy games, such as Tic-Tac-Toe, Connect4, and Chess (if it weren't so darn big). In particular, the purpose of Nova is to take learnings and ambitions from GamesmanClassic and provide a software system with an architecture that can accommodate them through meaningful, equally performant, and safe abstractions.
Installation
Before doing anything, you will want to install the Rust compiler and toolchain. GamesmanNova is on crates.io, so to get the nova executable, you can then run:
$ cargo install gamesman-nova
Otherwise, if you would like to build Nova from source, you can also:
- Clone this repository to your preferred
location.
$ git clone https://github.com/GamesCrafters/GamesmanNova.git location
- Go to your installation (
cd location), and install the executable:
$ cargo install --path .
This will add the nova executable to your list of cargo binaries.
Development
Important Fronts
The current big objectives for this project are:
- Supporting transferrable utility coalitional games (i.e., games where you can re-distribute winnings at the end among those who helped you win).
- Creating a memory-efficient and thread-safe implementation of GamesmanClassic's database engine.
- Designing a database file serialization protocol to make GamesmanClassic's databases compatible with Nova.
- Building a wonderful terminal user interface and expanding the current command-line interface.
- Implementing and wrapping a distributed MPI controller for solves on the Savio cluster.
Subprojects
Smaller modules currently being built:
- An implementation of the Crossteaser puzzle.
Contributing
This project was created in affiliation with GamesCrafters, a computational game theory applied research group at UC Berkeley. If you would like to contribute as someone outside the GamesCrafters org, feel free to fork the repository and open a PR. If you are part of the org, create a branch anytime and code away (but do let others know, so we can help or thank you). Some light CI is set up to ensure some loose measure of quality on the main branch (namely compilation, testing, and formatting checks).
-- Max Fierro, maxfierro@berkeley.edu