# maciejczyzewski/libchaos

Advanced library for randomization, hashing and statistical analysis (devoted to chaos machines). :microscope:

Repository: https://github.com/maciejczyzewski/libchaos
Canonical: https://ross.abutalabs.com/products/libchaos
Language: C++
License: NOASSERTION
License Family: other
Topics: chaos-machines, hash, random, math, crypto
Last push: 2019-11-02T22:59:13+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4602, "days_push": 2496, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1597, forks 158 (observed 2026-08-28T04:05:09.283235+00:00)

## What it is
A C++ library implementing randomization, hashing, and statistical analysis algorithms based on the concept of chaos machines. It aims to replace obsolete tools like TestU01, Dieharder, and Hashdeep with a modern, modular approach to pseudo-randomness.

## Use cases
- generate cryptographically-flavored password hashes with tunable cost parameters
- test the statistical quality of random number generators
- implement chaos machine based pseudo-random oracles
- benchmark and analyze hashing algorithms
- replace obsolete randomness testing tools like Dieharder or TestU01
- build custom PRNGs with configurable time, memory, and key parameters

## When to choose
- you need a modern C++ library for hashing and randomness research
- you want tunable pseudo-random functions with execution time, memory, and secret key parameters
- you are studying or experimenting with chaos theory applied to cryptography
- you need statistical analysis of randomization algorithms

## When to avoid
- you need a battle-tested, production-grade cryptographic library (use libsodium or OpenSSL instead)
- you need actively maintained software with recent releases
- you need a simple off-the-shelf RNG without research-oriented complexity
- your project is not in C++

## Facets
- artifact type: library
- maturity: maintenance
- function: cryptography, math, benchmarking, testing
- domain: security, mathematics, developer-tools
- platform: cpp, cross-platform, windows
- tags: hashing, randomization, chaos-machines, statistical-analysis, password-hashing, prng, algorithms, linux, macos

## Member repositories
- maciejczyzewski/libchaos (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:09.283235+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:54:00.079158+00:00, confidence not recorded.
  - readme: https://github.com/maciejczyzewski/libchaos (fetched 2026-08-28T04:05:09.283235+00:00, sha 55deff9cbb2b)
- Data as of 2026-08-30T08:39:29.467469+00:00.