Open AEA Framework

A framework for autonomous economic agent (AEA) development with no vendor lock-in

This is a fork of the original AEA project with the benefit that all vendor lock-in at the package level is removed. This means, there are no dependencies on centrally hosted registries for agent packages and the AEA itself does not prefer any package vendor over another. Where feasible, compatibility with the original AEA framework is maintained.

Get started developing AEAs

Create and launch a clean virtual environment with Python 3.10 (any Python >= 3.10 works):
```
python3.10 -m venv .venv && source .venv/bin/activate
```
Install the package from PyPI:
```
pip install open-aea[all]
```
Or, if you use zsh rather than bash:
```
pip install "open-aea[all]"
```
Then, build your agent as described in the docs.

Alternatively (1): Use `pipx` (CLI usage only)

Install pipx
Install the package from PyPI:
```
pipx install open-aea[all]
```
Run AEA CLI e.g.:
```
aea --help
```

Alternatively (2): Install from Source

This approach is not recommended!

Cloning

This repository contains submodules. Clone with recursive strategy:

git clone https://github.com/valory-xyz/open-aea.git --recursive && cd open-aea

To fetch/update submodules (for existing local repo):

git submodule sync --recursive && git submodule update --init --recursive

Dependencies

All python specific framework dependencies are specified in setup.py and installed with the framework. All development dependencies are specified in pyproject.toml (and installed via the commands specified in Preliminaries).

You can have more control on the installed dependencies by leveraging the setuptools' extras mechanism.

Preliminaries

Create and launch a virtual environment with Python 3.10 (any Python >= 3.10 works):
```
python3.10 -m venv .venv && source .venv/bin/activate
```
Install the package from source:
```
pip install .[all]
```
Or, if you use zsh rather than bash:
```
pip install ".[all]"
```
Then, build your agent as described in the docs.
Install Skaffold to manage containers & tagging:

curl -Lo skaffold https://storage.googleapis.com/skaffold/releases/v1.39.0/skaffold-linux-amd64 && \
sudo install skaffold /usr/local/bin/

Documentation

All documentation is hosted here.
To start a live-reloading docs server on localhost: mkdocs serve. To amend the docs, create a new documentation file in docs/ and add a reference to it in mkdocs.yml.
To run demos against local packages use flag --local in aea CLI commands.

Contributing

We welcome contributions to the framework, its plugins, related tools and packages. Please consult the contributing guide for details.

Cite

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

@misc{agents-aea,
  Author = {Marco Favorito and David Minarsch and Ali Hosseini and Aristotelis Triantafyllidis and Diarmid Campbell and Oleg Panasevych and Kevin Chen and Yuri Turchenkov and Lokman Rahmani and Jiří Vestfál and James Riehl and 8baller and Adamantios Zaras and David Vilela and Michiel Karrenbelt and Viraj Patel},
  Title = {Open Autonomous Economic Agent (AEA) Framework},
  Year = {2021},
}

Metadata

Release files for open-aea 2.2.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for open-aea 2.2.9
File	Size	Uploaded
open_aea-2.2.9.tar.gz	503.7 kB	Jun 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for open-aea 2.2.9
File	Interpreter	ABI	Platform	Reset
open_aea-2.2.9-py3-none-any.whl 688.6 kB Jun 24, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / open_aea-2.2.9.tar.gz

Download URL	open_aea-2.2.9.tar.gz
Size	503.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`b409b5a098815085c72f6161f47ba208d9a83c4960fc34328ed3a81de26eea0a`
BLAKE2b-256 checksum How to use checksums	`483d0bd18147346301c5e4abebb2940a712b739790e2fb62757c43988b6ba40d`
Upload date	Jun 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Release files / open_aea-2.2.9-py3-none-any.whl

Download URL	open_aea-2.2.9-py3-none-any.whl
Size	688.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`303454f09bb4382b568b78a40c10992639fdc2487be1e3dbec63d17fbd6423c2`
BLAKE2b-256 checksum How to use checksums	`7868e58651b6b4f1d084fbaa7ff50821fa4ede6b7cdef445a2063f5a80a812cb`
Upload date	Jun 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`