radiate

[dependencies]
radiate = { version = "1.3.2", features = ["x"] }

Python

pip install radiate # --or-- uv add radiate

Examples

Lets see a simple 'Hello World' example of using radiate to evolve a simple string - Hello, Radiate!. See the examples directory for a much more comprehensive set of examples in both languages.

import radiate as rd

target = "Hello, Radiate!"

engine = (
    rd.Engine.char(len(target))
    .fitness(
        lambda member: sum(1 for i in range(len(target)) if member[i] == target[i])
    )
    .limit(rd.Limit.score(len(target)))
)

result = engine.run(log=True)

print("Best solution:", "".join(result.value()))

Or in rust:

use radiate::prelude::*;

let target = "Hello, Radiate!";

let engine = GeneticEngine::builder()
    .codec(CharCodec::vector(target.len()))
    .fitness_fn(|geno: Vec<char>| {
        geno.into_iter()
            .zip(target.chars())
            .filter(|(allele, targ)| allele == targ)
            .count()
    })
    .build();

engine
    .iter()
    .logging()
    .until_score(target.len())
    .last()
    .unwrap();

Building & running from source

git clone https://github.com/pkalivas/radiate.git
cd radiate
just release 3.13

Radiate uses Just as a build tool, you can install it from here. The core build options are below, there are a few others that can be found through the just help command.

• just develop faster build time for development with debug symbols and minimal optimizations.
• just release slower build time for optimized runtime performance.

Both the above have an optional argument py to build the python package for a specific python version (e.g. just develop 3.12, just develop 3.13t for free-threading interpreter).

• just test-rs to run tests for rust
• just test-py to run tests for python package
• just test to run tests for both.
• just clean to nuke the build artifacts

Run examples with just example to run a small python script which shows & runs selected examples.

Contributing

Contributions are welcome. Pull requests should target the develop branch. If you use AI tools, disclose it in your PR or issue. See the AI usage policy.