#game #2048 #puzzle

bin+lib play-2048

Rust implementation of the famous 2048 game in the terminal

2 releases (1 stable)

1.0.0 Apr 28, 2020
0.1.0 Nov 23, 2019

#256 in Games


1.5K SLoC


Travis Build Status

This is a Rust implementation of the famous 2048 game which runs in the terminal.

In addition to the standard user inputs, an AI can be used to perform the moves. This AI leverages the expectiminimax algorithm to recommend the best next move at each step.

Game screenshot


Here are the statistics of the AI with its default parameters:

max tile reached frequency
2048 100 %
4096 100 %
8192 96 %
16384 70 %
32768 10 %

In particular, these statistics correspond to a minimum branch probability of 0.001. Decreasing this value would lead to better performance, as more branches would be explored, but this would also take more time.

Some other hardcoded parameters can be tweaked in order to further improve the algorithm. I have not performed an exhaustive grid search, thus the parameter set is probably sub-optimal.

Installation with Cargo

cargo install play-2048

Then, in order to play:


Installation from source

> git clone https://github.com/adrienball/2048-rs.git
> cd 2048-rs
> cargo run --release


You can change the probability of drawing a 4 tile:

> play-2048 --proba-4 0.5

Or adjust the minimum branch probability of the expectiminimax search:

> play-2048 --min-branch-proba 0.0001

To get the list of available options, simply run:

> play-2048 --help


Apache 2.0/MIT

All original work licensed under either of


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~28K SLoC