Dev-template

A template repository for developing agent services with the open-autonomy framework. Full documentation here.

System requirements

• 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:latest

This repository contains

• packages/ — the local registry (packages.json + dev/third_party trees) where your agents, skills, protocols and connections live.
• .env — prepends the project root to PYTHONPATH so local packages imports resolve.
• tox.ini — the full lint/format/check matrix (also run in CI).
• Makefile — shortcuts for the common workflows.

How to use

uv sync --all-groups

Run 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>/.

Useful commands

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)