A template repository for developing agent services with the open-autonomy framework. Full documentation here.
- Python
>=3.10, <3.15 - uv
>=0.11 - Tendermint
==0.34.19 - IPFS
==0.6.0 - Docker Engine and Docker Compose
Alternatively, a pre-built image ships with most runtime pieces (Tendermint and IPFS are not included):
docker pull valory/open-autonomy-user:latest
docker container run -it valory/open-autonomy-user:latestpackages/— the local registry (packages.json+dev/third_partytrees) where your agents, skills, protocols and connections live..env— prepends the project root toPYTHONPATHso localpackagesimports resolve.tox.ini— the full lint/format/check matrix (also run in CI).Makefile— shortcuts for the common workflows.
uv sync --all-groupsRun commands through uv run (e.g. uv run tox, uv run autonomy test) or activate the venv directly:
- Linux / macOS:
source .venv/bin/activate - Windows (PowerShell):
.venv\Scripts\Activate.ps1
Then start building under packages/<your-author>/<your-skill>/.
| Command | Purpose |
|---|---|
make formatters |
black + isort |
make code-checks |
black-check, isort-check, flake8, mypy, pylint, darglint |
make security |
safety, bandit, gitleaks |
make generators |
regenerate ABCI docstrings, refresh copyright headers, re-lock packages |
make common-checks-1 |
copyright + doc links + check-hash + check-packages |
make clean |
remove build/test/cache artefacts |
autonomy test |
run agent tests (see autonomy test --help) |