Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Autonomous Economic Agent framework

Project description


A framework for autonomous economic agent (AEA) development

Get started

  • Create and launch a virtual environment with Python 3.7:

    pipenv --python 3.7 && pipenv shell
  • Install the package from pypi:

    pip install aea[all]
  • Then, build your agent as described in the docs.

Alternatively: Install from Source


This repository contains submodules. Clone with recursive strategy:

  git clone --recursive && cd agents-aea


All python specific dependencies are specified in the Pipfile (and installed via the commands specified in 'Preliminaries').

Or, you can have more control on the installed dependencies by leveraging the setuptools' extras mechanism (more details later).


  • Create and launch a virtual environment:

    pipenv --python 3.7 && pipenv shell
  • Install the package from source:

    pip install .[all]
  • To install only specific extra dependencies, e.g. cli:

    pip install .[cli]


The following dependency is only relevant if you intend to contribute to the repository:

The following steps are only relevant if you intend to contribute to the repository. They are not required for agent development.

  • Install development dependencies:

    pipenv install --dev
  • Install package in (development mode):

    pip install -e .
  • After changes to the protobuf schema run:

    python protoc
  • To run tests (ensure no oef docker containers are running):

    tox -e py37
  • To run linters (code style checks):

    tox -e flake8
  • To run static type checks:

    tox -e mypy
  • Docs:

    • mkdocs serve - Start the live-reloading docs server on localhost.

To amend the docs, create a new documentation file in docs/ and add a reference to it in mkdocs.yml.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aea, version 0.1.13
Filename, size File type Python version Upload date Hashes
Filename, size aea-0.1.13-py2.py3-none-any.whl (163.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size aea-0.1.13.tar.gz (116.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page