{"id":13653923,"url":"https://github.com/valory-xyz/open-aea","last_synced_at":"2025-04-23T07:30:27.404Z","repository":{"id":36955283,"uuid":"422834772","full_name":"valory-xyz/open-aea","owner":"valory-xyz","description":"A framework for open autonomous economic agent (AEA) development - no package vendor is prioritised over other package vendors","archived":false,"fork":true,"pushed_at":"2025-03-28T17:42:32.000Z","size":128653,"stargazers_count":69,"open_issues_count":34,"forks_count":17,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-28T18:40:27.742Z","etag":null,"topics":["aea","agent","agent-framework","autonomous-agents","autonomous-economic-agents","cryptocurrencies","cryptocurrency","decentralized","multi-agent","multi-agent-systems","open-aea"],"latest_commit_sha":null,"homepage":"https://open-aea.docs.autonolas.tech","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"fetchai/agents-aea","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valory-xyz.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null}},"created_at":"2021-10-30T09:14:05.000Z","updated_at":"2025-03-13T09:09:45.000Z","dependencies_parsed_at":"2023-09-22T22:08:12.764Z","dependency_job_id":null,"html_url":"https://github.com/valory-xyz/open-aea","commit_stats":{"total_commits":10671,"total_committers":36,"mean_commits":296.4166666666667,"dds":0.7493205885109174,"last_synced_commit":"8d6c998eb3727996877893148e2ec1458ec32645"},"previous_names":[],"tags_count":132,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valory-xyz%2Fopen-aea","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valory-xyz%2Fopen-aea/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valory-xyz%2Fopen-aea/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valory-xyz%2Fopen-aea/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valory-xyz","download_url":"https://codeload.github.com/valory-xyz/open-aea/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250390784,"owners_count":21422782,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aea","agent","agent-framework","autonomous-agents","autonomous-economic-agents","cryptocurrencies","cryptocurrency","decentralized","multi-agent","multi-agent-systems","open-aea"],"created_at":"2024-08-02T02:01:20.814Z","updated_at":"2025-04-23T07:30:24.365Z","avatar_url":"https://github.com/valory-xyz.png","language":"Python","funding_links":[],"categories":["Relevant Links"],"sub_categories":["open-aea (Create Autonomous Economic Agents)"],"readme":"\u003ch1 align=\"center\"\u003e\n    \u003cb\u003eOpen AEA Framework\u003c/b\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/open-aea/\"\u003e\n    \u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/open-aea\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/open-aea/\"\u003e\n    \u003cimg alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/open-aea\"\u003e\n  \u003c/a\u003e\n  \u003ca\u003e\n    \u003cimg alt=\"PyPI - Wheel\" src=\"https://img.shields.io/pypi/wheel/open-aea\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/valory-xyz/open-aea/blob/main/LICENSE\"\u003e\n    \u003cimg alt=\"License\" src=\"https://img.shields.io/pypi/l/open-aea\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/open-aea/\"\u003e\n    \u003cimg alt=\"Downloads\" src=\"https://img.shields.io/pypi/dm/open-aea\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/valory-xyz/open-aea/actions/workflows/workflow.yml\"\u003e\n    \u003cimg alt=\"AEA framework sanity checks and tests\" src=\"https://github.com/valory-xyz/open-aea/workflows/AEA%20framework%20sanity%20checks%20and%20tests/badge.svg?branch=main\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"\"\u003e\n    \u003cimg alt=\"Codecov\" src=\"https://img.shields.io/codecov/c/github/valory-xyz/open-aea\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/lint-flake8-blueviolet\"\u003e\n    \u003cimg alt=\"flake8\" src=\"https://img.shields.io/badge/lint-flake8-yellow\" \u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/python/mypy\"\u003e\n    \u003cimg alt=\"mypy\" src=\"https://img.shields.io/badge/static%20check-mypy-blue\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/psf/black\"\u003e\n    \u003cimg alt=\"Black\" src=\"https://img.shields.io/badge/code%20style-black-black\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/PyCQA/bandit\"\u003e\n    \u003cimg alt=\"mypy\" src=\"https://img.shields.io/badge/security-bandit-lightgrey\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nA framework for autonomous economic agent (AEA) development with no vendor lock-in\n\u003c/p\u003e\n\nThis is a fork of \u003ca href=\"https://github.com/fetchai/agents-aea\"\u003ethe original AEA project\u003c/a\u003e 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.\n\n## Get started developing AEAs\n\n1. Create and launch a clean virtual environment with Python 3.10 (any Python `\u003e=` 3.8 works):\n\n       pipenv --python 3.10 \u0026\u0026 pipenv shell\n\n2. Install the package from [PyPI](https://pypi.org/project/open-aea/):\n\n       pip install open-aea[all]\n\n    Or, if you use `zsh` rather than `bash`:\n\n       pip install \"open-aea[all]\"\n\n3. Then, build your agent as described in the [docs](https://open-aea.docs.autonolas.tech/).\n\n## Alternatively (1): Use `pipx` (CLI usage only)\n\n1. Install [pipx](https://github.com/pipxproject/pipx)\n\n2. Install the package from [PyPI](https://pypi.org/project/aea/):\n\n       pipx install open-aea[all]\n\n3. Run AEA CLI e.g.:\n\n       aea --help\n\n## Alternatively (2): Install from Source\n\nThis approach is not recommended!\n\n### Cloning\n\nThis repository contains submodules. Clone with recursive strategy:\n\n    git clone https://github.com/valory-xyz/open-aea.git --recursive \u0026\u0026 cd open-aea\n\n- To fetch/update submodules (for existing local repo):\n\n      git submodule sync --recursive \u0026\u0026 git submodule update --init --recursive\n\n### Dependencies\n\nAll python specific framework dependencies are specified in `setup.py` and installed with the framework. All development dependencies are specified in `Pipfile` (and installed via the commands specified in [Preliminaries](#preliminaries)).\n\nYou can have more control on the installed dependencies by leveraging the setuptools' extras mechanism.\n\n### Preliminaries\n\n- Create and launch a virtual environment with Python 3.10 (any Python `\u003e=` 3.8 works):\n\n      pipenv --python 3.10 \u0026\u0026 pipenv shell\n\n- Install the package from source:\n\n      pip install .[all]\n\n    Or, if you use `zsh` rather than `bash`:\n\n      pip install \".[all]\"\n\n- Then, build your agent as described in the [docs](https://open-aea.docs.autonolas.tech/).\n\n- Install Skaffold to manage containers \u0026 tagging:\n\n```bash\ncurl -Lo skaffold https://storage.googleapis.com/skaffold/releases/v1.39.0/skaffold-linux-amd64 \u0026\u0026 \\\nsudo install skaffold /usr/local/bin/\n```\n## Documentation\n\n- All documentation is hosted [here](https://open-aea.docs.autonolas.tech/).\n\n- 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`.\n\n- To run demos against local packages use flag `--local` in `aea` CLI commands.\n\n## Contributing\n\nWe welcome contributions to the framework, its plugins, related tools and packages. Please consult the [contributing guide](https://github.com/valory-xyz/open-aea/blob/main/CONTRIBUTING.md) for details.\n\n## Cite\n\nIf you are using our software in a publication, please\nconsider to cite it with the following BibTex entry:\n\n```\n@misc{agents-aea,\n  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},\n  Title = {Open Autonomous Economic Agent (AEA) Framework},\n  Year = {2021},\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalory-xyz%2Fopen-aea","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalory-xyz%2Fopen-aea","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalory-xyz%2Fopen-aea/lists"}