Python agents that auto-register on a blockchain
It turns decorated Python functions into autonomous agents with cryptographic identities on the Fetch.ai blockchain.

What it does
uAgents is a Python framework from Fetch.ai for building event-driven autonomous agents. You define behavior with decorators—say, running a task on an interval—and the library handles the lifecycle. Every agent gets a cryptographic keypair and, on startup, registers itself on the Almanac, a smart contract on the Fetch.ai blockchain, so other agents can find it.
The interesting bit
The blockchain integration isn’t an afterthought; it’s the plumbing. Identity, messaging security, and network discovery are tied to on-chain registration from day one, which is unusual for a Python asyncio-style agent library. There’s even a compatibility path for ASI:One agents.
Key highlights
- Agents are plain Python objects with decorator-based event handlers (
@agent.on_interval). - Cryptographic identities and wallets are built-in; messages are signed and secured.
- Automatic registration to the Fetch.ai Almanac smart contract on startup.
- Supports synchronous communication, broadcast messaging, and local storage.
- Includes
uagents-corefor integrating with the broader Fetch.ai ecosystem and agent marketplace.
Caveats
- The project carries a stark disclaimer: it is provided “as-is” with no warranty, and users assume all risks including data loss or unexpected behavior.
- If you omit a seed phrase when creating an agent, a new blockchain address is generated on every run; persistent identity requires explicit key management.
- The README is largely a quickstart pointer; most advanced behavior lives in external documentation.
Verdict
Worth a look if you are already building on Fetch.ai or need blockchain-native agent discovery. Skip it if you just want a generic Python task scheduler or LLM glue; the on-chain identity is the point, not the side effect.
Frequently asked
- What is fetchai/uAgents?
- It turns decorated Python functions into autonomous agents with cryptographic identities on the Fetch.ai blockchain.
- Is uAgents open source?
- Yes — fetchai/uAgents is open source, released under the Apache-2.0 license.
- What language is uAgents written in?
- fetchai/uAgents is primarily written in Python.
- How popular is uAgents?
- fetchai/uAgents has 1.6k stars on GitHub.
- Where can I find uAgents?
- fetchai/uAgents is on GitHub at https://github.com/fetchai/uAgents.