Metadata-Version: 2.1
Name: abrain
Version: 1.0rc0
Summary: NeuroEvolution in Python backed by C++ computations
Author-email: Kevin Godin-Dubois <k.j.m.godin-dubois@vu.nl>
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Artificial Life
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: plotly
Requires-Dist: configobj
Requires-Dist: importlib-resources
Requires-Dist: graphviz
Requires-Dist: pyrecord
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'
Requires-Dist: sphinx-pyproject ; extra == 'docs'
Requires-Dist: sphinx-design ; extra == 'docs'
Requires-Dist: matplotlib ; extra == 'docs'
Provides-Extra: kaleido
Requires-Dist: kaleido ; extra == 'kaleido'
Provides-Extra: tests
Requires-Dist: pytest ; extra == 'tests'
Requires-Dist: pytest-steps ; extra == 'tests'
Requires-Dist: pytest-sugar ; extra == 'tests'
Requires-Dist: coverage ; extra == 'tests'
Requires-Dist: flake8 ; extra == 'tests'

# Artificial Brains (ABrain) for Python

[![Documentation Status](https://readthedocs.org/projects/abrain/badge/?version=latest)](https://abrain.readthedocs.io/en/latest/?badge=latest)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-flake.md)

### Release
![](https://img.shields.io/badge/on-!-900?logo=pypi)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-wheel-manylinux.md)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-wheel-musllinux.md)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-wheel-macosx.md)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-wheel-win.md)

### Development
![](https://img.shields.io/badge/version-!-900)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-tests.md)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-cov.md)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-pcov.md)
![](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/wiki/kgd-al/abrain/badge-ccov.md)


C++/Python implementation of the genotype/phenotype components of Evolvable Substrate HyperNEAT (read without evolution and speciation).

## Optional dependencies:

### Graphviz (dot)

To generate directed graphs for the genomes
Can only be fetched by system installer (apt-get, yum, ...)
See https://graphviz.org/download/ for instructions

### Kaleido

To generate non-interactive images of ANN (through plotly)
Due to inconsistent support, left as an optional dependency
Use `pip install abrain[...,kaleido]` to get it

## Todo list:
 - Functionalities:
   - Order-independent ANN evaluation (with back buffer)?
   - Crossover / historical markings
     - Actually needed?
   - MANN Integration
     - Easy extraction
     - built-in testing
     - C++ wrapper
     - Visu
     
  - Misc:
    - Documentation
      - Usage
      
    - Continuous integration
      - build / tests
      - Badges
      
    - Packaging:
      - include c++ stubs?
      - move to scikit/poetry/... ?
      
    - Installation errors:
      - cp38,...,311-manylinux_i686 fail because cppn outputs diverge between manual and subset/all
        > Caused by unmatched image/host platforms?
        > Heisenbug, printing an FNode value before returning it makes it work
        > Also disapears in when compiling in debug mode
      - pp38,39-manylinux_i686,x86_64; pp38,39-macosx_x86_64; pp38,39-win_amd64 fail because of strange import error in numpy
        > Solved by removing numpy dependency
      - cp38,...,311-musllinux_i686 fail because pillow needs a jpeg library
        > Solved? Added libjpeg to the apk (musllinux) install
        > Removed pillow dependency
      - cp38,..,311-win32,amd64 fail because of encoding error in ANN rendering
