A tool for predicting the output of random number generators
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.



foresight is a python library for predicting the output of random number generators across a variety of platforms and languages including:

  • glibc
  • MSVC
  • PHP
  • Java
  • MySQL

This repository also contains a simple wrapper (called foresee) around this library that provides a CLI.


To install foresight, clone this repository and run python setup.py install.

Library Usage

The library is divided into subpackages for each supported platform. These subpackages then provide submodules for each supported function. For example,the following sample will predict the output of the glibc rand_r from some prior outputs:

from foresight.glibc import rand_r

prior_outputs = [int(i) for i in input().split()]
future_outputs = rand_r.from_outputs(prior_outputs)

for output in future_outputs:

Generally, each module provides the following functions:

  • from_seed(seed): get a generator to the future values returned by the RNG when seeded with the given value.

  • from_outputs(prev_values): attempt to predict the internal state of the RNG from the given prior outputs. If successful, returns a generator to the future values returned by the RNG.

CLI Usage

Command line usage of the library has the following general form:

foresee <platform> <function> [<options>]

For example, the above script is equivalent to the following foresee command:

foresee glibc rand_r -o <the prior outputs>

By default, an infinite stream is generated. The output may be limited to the next N outputs with -c N.


Tests can be run with nose by first installing the package with pip install nose, and then running nosetest in the project root.


This project is licensed under the terms of the MIT license. See the LICENSE file for details


Keeping in mind that this project is still fairly unstable, contributions are welcome.