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.3.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.3-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: x_evolution-0.0.3.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.3.tar.gz
Algorithm Hash digest
SHA256 37984fb1b76f5175e7d0fcc42a8b4287ddf1b16271ab7c36e220a5e7ddffc074
MD5 5db6db4e20b226df6b276be0465dbc90
BLAKE2b-256 02a654df9f4e8d7affc11bcd17a5c0eab55ed1ad70124a369533f7df03fe93a3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: x_evolution-0.0.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 16377b49fcda9f5ca942c8ad18e771f46f2be88d717367f0fa9c1b437703e96e
MD5 0114805b7cf26ec1c4b71ae78f1b2c2f
BLAKE2b-256 afa028a99402eea5377e69d57dea88607177439ac9ee5a4af430f6d89a58ad18

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