seeded-random-utils/llms.txt at main · FerrowAI/seeded-random-utils · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# seeded-random-utils

> Deterministic random number generators (Mulberry32, Xoshiro128) with sampling, shuffle, weighted pick, and gaussian.

Generate reproducible randomness from seed for tests and simulation. Two PRNGs: Mulberry32 (fast) and Xoshiro128 (better stats). Same seed → identical sequence; fork() for substreams.

## API

- `Mulberry32(seed)` — float(), int(min, max), pick(), shuffle(), sample(), gaussian(), fork()
- `Xoshiro128(seed)` — same methods

## Install

```bash
npm install @ferrow/seeded-random-utils
```

Part of the Ferrow open-source toolkit: https://github.com/FerrowAI/ferrow-toolkit — sponsored by https://ferrow.ai