Skip to main content

x-evolution

Project description

x-evolution (wip)

Implementation of various evolutionary algorithms, starting with evolutionary strategies

Install

$ pip install x-evolution

Usage

import torch
from x_evolution import EvoStrategy

# model

from torch import nn
model = torch.nn.Sequential(
    nn.Linear(8, 16),
    nn.ReLU(),
    nn.Linear(16, 4)
)

# evolution wrapper

evo_strat = EvoStrategy(
    model,
    environment = lambda model: torch.randint(0, 100, ()), # environment is just a function that takes in the individual model (with unique noise) and outputs the fitness - you can select for whatever you want here, does not have to be differentiable.
    noise_population_size = 30,
    num_generations = 100,
    learning_rate = 1e-3,
    noise_scale = 1e-3
)

# do evolution with your desired fitness function for so many generations

evo_strat()

# then save your evolved model, maybe for alternating with gradient based training

torch.save(model.state_dict(), './evolved.pt')

Distributed

Using the CLI from 🤗

$ accelerate config

Then

$ accelerate launch train.py

Citations

@article{Qiu2025EvolutionSA,
    title   = {Evolution Strategies at Scale: LLM Fine-Tuning Beyond Reinforcement Learning},
    author  = {Xin Qiu and Yulu Gan and Conor F. Hayes and Qiyao Liang and Elliot Meyerson and Babak Hodjat and Risto Miikkulainen},
    journal = {ArXiv},
    year    = {2025},
    volume  = {abs/2509.24372},
    url     = {https://api.semanticscholar.org/CorpusID:281674745}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

x_evolution-0.0.4.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

x_evolution-0.0.4-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file x_evolution-0.0.4.tar.gz.

File metadata

  • Download URL: x_evolution-0.0.4.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for x_evolution-0.0.4.tar.gz
Algorithm Hash digest
SHA256 3cd1be79e1f4edf5586022e8d3d6ee1ef3fbfb0919c3be2fcd578fa2f7984a7d
MD5 18b9f3d715377d8c26f483f788c168b2
BLAKE2b-256 0748b38ded805d4e5f6da3cdabc3ca4d96ff6dc99e422fb2734e18dc7c3f1ef0

See more details on using hashes here.

File details

Details for the file x_evolution-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: x_evolution-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for x_evolution-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 233ec11ca8160095c4d4092aa8bb34911419fad5c820bf50f1dfdad3b1fe5f6d
MD5 3819ef530570b8e1431138242614f0af
BLAKE2b-256 74b20aced577b9fa9e8d07df1136dc88952509e7be9fe094ebd84404f76f9a56

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page