connect-four-ai is both an executable binary that can be run, and a library that can be used in Rust programs.
Installing benchmark evaluate_difficulties generate_book executables
Assuming you have Rust/Cargo installed , run this command in a terminal:
cargo install connect-four-ai
It will make benchmark evaluate_difficulties generate_book commands available in your PATH if you've allowed the PATH to be modified when installing Rust . cargo uninstall connect-four-ai uninstalls.
Adding connect_four_ai library as a dependency
Run this command in a terminal, in your project's directory:
cargo add connect-four-ai
To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:
connect-four-ai = "1.0.0"
The connect_four_ai library will be automatically available globally.
Read the connect_four_ai library documentation .
Back to the crate overview .
Readme
Connect Four AI
A high-performance, perfect Connect Four solver written in Rust, with bindings for Python and WebAssembly.
This library can strongly solve any Connect Four position and determine the optimal move.
For full details, performance benchmarks, and demos, please see the main
GitHub Repository .
Key Features
Perfect Solver : Implements an optimised negamax search,
which utilises alpha-beta pruning and a transposition table
to quickly converge on exact game outcomes.
AI Player : Features an AI player with configurable difficulty. It can play
perfectly by always choosing the optimal move, or can simulate a range of
skill levels by probabilistically selecting moves based on their scores.
Bitboard Representation : Uses a compact and efficient bitboard representation for
game positions, allowing for fast move generation and evaluation.
Embedded Opening Book : Includes a pre-generated opening book of depth 8, which is
embedded directly into the binary for instant lookups of early-game solutions.
Parallel Book Generator : A tool built with rayon for generating new, deeper
opening books.
Cross-Platform : Available as a Rust crate, Python package, and WebAssembly module for
seamless integration into a wide range of projects.
Installation
This library can be added to a Cargo project by running the following command in your
project directory:
cargo add connect-four-ai
or by adding the following line to your Cargo.toml:
connect-four-ai = " 1.0.0"
Example Usage
This is a basic example of how to use the Solver to find the score of a position:
use connect_four_ai:: { Solver, Position} ;
fn main ( ) {
// Creates a position from a sequence of 1-indexed moves
let position = Position:: from_moves( " 76461241141" ) . unwrap ( ) ;
// Initialises and uses the Solver to calculate the exact score of the position
let mut solver = Solver:: new( ) ;
let score = solver. solve ( & position) ;
println! ( " {score} " ) ; // Output: -1
}
License
This project is licensed under the MIT License . See the LICENSE file for details.