by buckyroberts

buckyroberts /Ella

Self-improving decision organism

452 Stars 87 Forks Last release: Not found 34 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Ella is a self-improving decision organism.


This program is designed to iterate through a dataset and may choose to perform an action based on analysis of the data.

  • Condition - expression to be evaluated
  • Action - function that will be invoked if the related condition evaluates to true
  • Neuron - pairing of an action to one or more conditions
  • Brain - collection of all neurons

Diagram of Basic Neuron

Example Usage

Ella works by first analyzing the dataset provided by the user:

  {"date": "1/1/17", "price": 25.48, "volume": 5500},
  {"date": "1/2/17", "price": 19.64, "volume": 1600},
  {"date": "1/3/17", "price": 25.57, "volume": 4800},
  {"date": "1/4/17", "price": 32.63, "volume": 2100},
  {"date": "1/5/17", "price": 29.85, "volume": 3700}

She will then begin building the neurons by first generating random conditions based on the data.

volume > 3700
price < 19.64

Once conditions have been created, they are mapped to an action (creating the full neuron):

volume > 3700 - BUY
price < 19.64 - SELL

Ella will continue to create neurons until all actions have been mapped to a condition and the brain is complete. This will ensure that the brain will have the ability to perform all possible functions.

Once full brain has been constructed, Ella will iterate over the dataset row by row and invoke all action events (fire the neuron) if a condition is met. Therefore for each row analyzed, Ella may invoke multiple, a single, or no action events depending on how many conditions were met.

Example using the above neurons and dataset: ``` Starting value: $1000.00

Conditions: volume > 3700 - BUY price < 19.64 - SELL

---------- ANALYSIS ----------

Day 1 - {'price': 25.48, 'volume': 5500} volume 5500 > 3700 -> BUY

Day 2 - {'price': 19.64, 'volume': 1600}


Day 3 - {'price': 25.57, 'volume': 4800} volume 4800 > 3700 -> BUY

Day 4 - {'price': 32.63, 'volume': 2100}


Day 5 - {'price': 29.85, 'volume': 3700}


---------- RESULTS ----------

Final value: $1008.65 ```


Feel free to contribute any by providing any bug fixes, suggestions, ideas, or anything else that may be of help.

Also, please note that this is just a small program I wrote this morning because I was bored waiting for the hockey game to start. It will most likely not be actively maintained, however I will check back frequently for pull requests and may also add some new features in my spare time.

  • Python 3.6 (or newer) required


We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.