gamesman-nova

Crates.iogamesman-nova
lib.rsgamesman-nova
version0.1.5
sourcesrc
created_at2023-11-09 09:02:14.458212
updated_at2023-12-19 18:27:00.134961
descriptionSystem for computing the solution set of finite, deterministic, complete-information, abstract-strategy games.
homepage
repositoryhttps://github.com/GamesCrafters/GamesmanNova
max_upload_size
id1029959
size156,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:

  1. Clone this repository to your preferred location.
$ git clone https://github.com/GamesCrafters/GamesmanNova.git location
  1. 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:

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

Commit count: 115

cargo fmt