evo-ens - Evolutionary Ensemble Builder
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
- Full documentation (user guide + API reference): https://evo-suite.readthedocs.io/
- Runnable examples: the repository's
examples/evo-ens/directory.
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
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)
| File | Size | Uploaded | |
|---|---|---|---|
| evo_ens-0.1.0.tar.gz | 23.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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