open-autonomy 0.3.3

A framework for the creation of autonomous agent services.

Open Autonomy Framework

Open Autonomy is a framework for the creation of Agent Services: off-chain services which run as a multi-agent-system (MAS) and are replicated on a temporary consensus gadget (blockchain) while being crypto-economically secured on a public blockchain, hence offering robustness, transparency and decentralization off-chain.

As opposed to traditional smart contracts, Valory apps go beyond simple, purely on-chain logic without giving up on decentralization.

Get started developing autonomous services

1. Create and launch a clean virtual environment with Python 3.10 (any Python >= 3.7 works):

   pipenv --python 3.10 && pipenv shell
   

2. Install the package from PyPI:

   pip install open-autonomy
   

3. Then, build your services as described in the docs.

For developers contributing to the framework: Install from Source

• Ensure your machine satisfies the following requirements:

  • Python >= 3.7
  • Tendermint ==0.34.19
  • IPFS node ==v0.6.0
  • Pip
  • Pipenv >=2021.x.xx
  • Go ==1.17.7
  • Kubectl
  • Docker Engine
  • Docker Compose
  • Skaffold >= 1.39.1
  • Gitleaks

• Clone the repository:

  git clone [e-mail]:valory-xyz/open-autonomy.git
  

• Pull pre-built images:

  docker pull valory/autonolas-registries:latest
  docker pull valory/contracts-amm:latest
  docker pull valory/safe-contract-net:latest
  

• Create and launch a virtual environment. Also, run this during development, every time you need to re-create and launch the virtual environment and update the dependencies:

  make new_env && pipenv shell
  

  :information_source: Note: we are using atheris in order to perform fuzzy testing. The dependency is not listed in the Pipfile because it is not supported on Windows. If you need to run or implement a fuzzy test, please manually install the dependency. If you are developing on Mac, please follow the extra steps described here.

• Fetch packages:

  autonomy packages sync --update-packages
  

Cite

If you are using our software in a publication, please consider to cite it with the following BibTex entry:

@misc{open-autonomy,
  Author = {David Minarsch and Marco Favorito and Viraj Patel and Adamantios Zaras and David Vilela Freire and Michiel Karrenbelt and 8baller and Ardian Abazi},
  Title = {Open Autonomy Framework},
  Year = {2021},
}