https://github.com/jesselawson/cares

Cellular Agent Research Experiment System ("CARES"), for creating programmable agents in a discrete system of cells and then seeing how they evolve.
https://github.com/jesselawson/cares

artificial-intelligence autonomous-agents python python3

Last synced: 14 days ago
JSON representation

Cellular Agent Research Experiment System ("CARES"), for creating programmable agents in a discrete system of cells and then seeing how they evolve.

• Host: GitHub
• URL: https://github.com/jesselawson/cares
• Owner: jesselawson
• License: gpl-3.0
• Created: 2019-03-28T14:03:21.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-05-02T19:38:05.000Z (over 5 years ago)
• Last Synced: 2024-10-04T21:36:35.803Z (about 1 month ago)
• Topics: artificial-intelligence, autonomous-agents, python, python3
• Language: Python
• Homepage:
• Size: 24.6 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Cellular Agent Research Experiment System (CARES)

The Cellular Agent Research Experiment System (CARES) is a modular, programmable

toolset designed to study autonomous agents in a discrete, cellular environment. 

# Quickstart

1. Clone the repository: `git clone https://github.com/jesselawson/cares.git`

2. Install dependencies: `cd cares && pip install -r requirements.txt`

3. Run the example experiment: `python experiments/example1.py`

4. Study the output in the `experiments/example1` folder. You'll have a compiled gif of

all state configurations at each time step, and *.jpg copies of the state configuration 

at each time step. 

# Roadmap

**Current Status: Pre-Alpha**

CARES is almost ready for it's alpha release. Right now it is a solid 

proof-of-concept. Please check the issues for help with roadmap items, or

for bugs identified.

**"avocado"**

The "avocado" release is the first MVP release (post proof-of-concept).

* Move _all_ subroutines to new modular format

* Convert agent update logic into subroutine 

**"burrito"**

The "burrito" release is the first beta release.

* Add matplotlib to state configuration outputs

    * How can it be configured?

* Integrate sqlite (or other db) for sensory_input and association storage

* Add new sensors: 

    * AgentSensorSubroutineListen

    * AgentSubroutineListen

By the time Burrito is released, we should be forming associations between

the different sensory input data. For example, `smell01` might be associated

with `sound44` and `taste32`. 

# Documentation

The full documentation is available [here](https://jesselawson.org/cares).

# Contributing 

This project is intended to be a safe, welcoming space for collaboration, and 

contributors are expected to adhere to the 

[Contributor Covenant](http://contributor-covenant.org/) code of conduct.

1. Fork the repo.

2. Make your changes. 

3. Submit a pull request.

It's that easy!