GALib
A small, extensible library to build genetic algorithms in Python 3.10+. Fully typed, no dependencies in the core, optional numpy acceleration.
Documentation: https://carmelolg.github.io/GALib/
Distribution name (pip install) |
carmelolg-galib |
| Import name | carmelolg.galib |
carmelolg is a PEP 420 namespace package.
Quick start
import string
from carmelolg.galib import GeneticAlgorithm, Problem, TargetFitness
TARGET = "hello world"
ALPHABET = string.ascii_lowercase + " "
class Phrase(Problem[str]):
def random_genome(self, rng): # one random candidate
return "".join(rng.choice(ALPHABET) for _ in TARGET)
def random_gene(self, rng): # enables the default mutation
return rng.choice(ALPHABET)
def fitness(self, genome): # higher is better (set `maximize = False` to minimise)
return sum(a == b for a, b in zip(genome, TARGET))
result = GeneticAlgorithm(Phrase(), stop=[TargetFitness(len(TARGET))], seed=1).run()
print(result.best.genome) # hello world
Features
- Three levels of customisation: parameters; pluggable operators (any callable, or methods on your
Problem); subclasses of the engine overridingselect,crossover,mutate,reproduce,replace, ... - Operators for sequences (
OnePoint,TwoPoint,Uniform,RandomReset), permutations (OrderCrossover,PartiallyMappedCrossover,SwapMutation,InversionMutation) and real values (BlendCrossover,GaussianMutation); selection byTournament,Roulette,Rank. - Monitoring: per-generation statistics and diversity, callbacks (
PrintProgress), stop conditions (TargetFitness,Stagnation,TimeLimit), plots. - Performance: vectorised
fitness_batch, numpy array genomes, parallel evaluation with any executor. - Reproducible: each run has its own seeded random generator.
Development
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev,docs]"
python -m pytest --cov # tests with branch coverage
mypy # strict type checking
ruff check src tests examples benchmarks # lint
mkdocs serve # documentation preview on http://127.0.0.1:8000
python examples/tsp.py # examples: phrase, knapsack, tsp, rastrigin
The documentation sources are in docs/ (MkDocs Material); .github/workflows/docs.yml publishes them to
GitHub Pages, .github/workflows/ci.yml runs tests, types, lint and the docs build.
License
Copyright 2026 CARMELO LA GAMBA. Licensed under the Apache License, Version 2.0. Redistributions must keep the copyright notices and include the NOTICE file.
Metadata
Release files for carmelolg-galib 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| carmelolg_galib-0.2.1.tar.gz | 34.5 kB | With provenance | Details for carmelolg_galib-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| carmelolg_galib-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for carmelolg_galib-0.2.1-py3-none-any.whl |
Total release size: 65.2 kB
Release files / carmelolg_galib-0.2.1.tar.gz
| Download URL | carmelolg_galib-0.2.1.tar.gz |
|---|---|
| Size | 34.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
492ad6c0c41cec35cf4e17d5a827d841ba930c64c223bca250e3d021a9af4c79
|
|
BLAKE2b-256 checksum How to use checksums |
46233c043ce042680e2f70c1816486d7a7166343b3b1bdcdbbe8eee10dfa4a30
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 17, 2026.
Transparency logRelease files / carmelolg_galib-0.2.1-py3-none-any.whl
| Download URL | carmelolg_galib-0.2.1-py3-none-any.whl |
|---|---|
| Size | 30.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
61357c31a75c60ef3346fd35d443ecb10e6b8c482273fdaef84704d6007ecec6
|
|
BLAKE2b-256 checksum How to use checksums |
922565bba5fd8191dc0c503760b1ed00cd298292395a2c6f2c98dc11c53cf18d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 17, 2026.
Transparency logSecurity for carmelolg-galib 0.2.1
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for carmelolg_galib-0.2.1.tar.gz
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 Nov 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.