---
name: fetch-ai
description: Use when evaluating Fetch.ai, Agentverse, or uAgents for CeliacBot agent discovery, publication, or ASI network experiments. Prefer the official uAgents docs and the local isolated toolchain in `.data/fetch-ai-venv`.
---

# Fetch.ai / Agentverse / uAgents

Use this skill when working on Fetch.ai distribution, Agentverse registration, or a uAgents prototype for CeliacBot.

## Official surfaces

- uAgents docs: https://uagents.fetch.ai/docs
- Install: https://uagents.fetch.ai/docs/getting-started/install
- First agent: https://uagents.fetch.ai/docs/getting-started/create
- Agentverse mailbox: https://uagents.fetch.ai/docs/agentverse/mailbox
- Agentverse proxy: https://uagents.fetch.ai/docs/agentverse/proxy
- Local inspector: https://uagents.fetch.ai/docs/agentverse/inspector
- ASI:One-compatible example: https://uagents.fetch.ai/docs/examples/asi-1

## Local tooling verified in this repo

- Isolated venv: `.data/fetch-ai-venv`
- Installed packages:
  - `uagents==0.25.2`
  - `uagents-core==0.4.7`
- Verified CLI:
  - `.data/fetch-ai-venv/bin/av --help`
- Verified import:
  - `.data/fetch-ai-venv/bin/python -c "import uagents"`

Note: the useful CLI here is `av`, exposed by `uagents-core.agentverse.cli`. There is no separate verified `uagents` shell command in this environment.

## Guidance

- For hackathon scope, treat Fetch as a distribution or discoverability layer after the core restaurant evidence flow works.
- Prefer a minimal local agent first, then connect it to Agentverse with Mailbox or Proxy once the message contract is stable.
- Keep `AGENTVERSE_API_KEY`, ASI keys, and agent seed phrases in environment variables only.
- Do not use the unrelated PyPI package `agentverse` from OpenBMB for Fetch.ai work. Its package name collides with Fetch's Agentverse but it is a different project.

## Minimal local commands

```bash
python3 -m venv .data/fetch-ai-venv
.data/fetch-ai-venv/bin/pip install uagents
.data/fetch-ai-venv/bin/av --help
```