Skip to main content

evo-ens - Evolutionary Ensemble Builder

PyPI Python versions Docs CI License: MIT

A scikit-learn-compatible ensemble constructor for tabular data, powered by DEAP. evo-ens uses a Genetic Algorithm to decide which candidate models to combine and how to weight them, trading off predictive score against prediction diversity, complementing evo-gafs (feature selection) and evo-gpfe (feature engineering) further upstream in the pipeline.

Part of the evo-suite family (import name: evo_ens). Documentation: https://evo-suite.readthedocs.io/

Why evo-ens?

Capability evo-ens
Diversity-aware fitness: score minus a Q-statistic / Pearson-correlation penalty Yes
Out-of-fold pre-computation: candidates cross-validated once, evolution stays cheap Yes
Native scikit-learn EvoEnsembleClassifier / EvoEnsembleRegressor, usable in a Pipeline Yes
Multi-objective NSGA-II mode exposing the full score/compression Pareto front Yes
min_models / max_models constraints for edge-deployment budgets Yes
Built-in multi-dataset EvoEnsBenchmarkRunner Yes

Installation

pip install evo-ens            # core
pip install "evo-ens[viz]"     # + matplotlib for the plotting helpers

Quickstart

from sklearn.datasets import load_breast_cancer
from evo_ens import EvoEnsConfig, EvoEnsembleClassifier

X, y = load_breast_cancer(return_X_y=True, as_frame=True)

clf = EvoEnsembleClassifier(
    config=EvoEnsConfig(population_size=60, n_generations=40, diversity_beta=0.10, verbose=False)
)
clf.fit(X, y)

print(clf.result_.summary())
print(clf.get_ensemble_info())

EvoEnsembleRegressor follows the same API for regression targets, scoring with R² by default.

Documentation & examples

Citation

@software{evo_ens,
  author    = {Skrauba, Axel},
  title     = {evo-ens: Evolutionary Ensemble Builder for tabular data},
  year      = {2026},
  version   = {0.1.0},
  url       = {https://github.com/AxelSkrauba/evo-suite}
}

License

MIT

Metadata

Release files for evo-ens 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for evo-ens 0.1.0
File Size Uploaded
evo_ens-0.1.0.tar.gz 23.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for evo-ens 0.1.0
File Interpreter ABI Platform
evo_ens-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 50.6 kB

Release files / evo_ens-0.1.0.tar.gz

Download URL evo_ens-0.1.0.tar.gz
Size 23.7 kB
Tags Source
SHA-256 checksum
How to use checksums
2a0a62781cbc02b73b9f3171b60c85f05c44fc87c8e2ae7caf80c9211a1cd3f5
BLAKE2b-256 checksum
How to use checksums
be705170c832d0bcae37f54cd44a8f26ad41be99ce8b23cfe34484ac1a68f991
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 26, 2026.

Transparency log

Release files / evo_ens-0.1.0-py3-none-any.whl

Download URL evo_ens-0.1.0-py3-none-any.whl
Size 26.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3345a18f324648930158c541a7f0e0b28cec960bebfbce0c887933e9f16a798c
BLAKE2b-256 checksum
How to use checksums
124355dabd6027a0f6d0ecd3f1a11b81ed729fabc73a0a916495b84874459ef9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 26, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page