uAgents: AI Agent Framework
uAgents is a library developed by Fetch.ai that allows for creating autonomous AI agents in Python. With simple and expressive decorators, you can have an agent that performs various tasks on a schedule or takes action on various events.
🚀 Features
- 🤖 Easy creation and management: Create any type of agent you can think of and implement it in code.
- 🔗 Connected: On startup, each agent automatically joins the fast-growing network of uAgents by registering on the Almanac, a smart contract deployed on the Fetch.ai blockchain.
- 🔒 Secure: uAgent messages and wallets are cryptographically secured, so their identities and assets are protected.
- 📊 Observable: Agents registered on Agentverse automatically report start/stop, message (sent/received), and error telemetry events to the Agentverse dashboard (toggle with
report_events).
⚡ Quickstart
Installation
Get started with uAgents by installing it for Python 3.10 to 3.13:
pip install uagents
Running a Demo
Creating an Agent
Build your first uAgent using the following script:
from uagents import Agent, Context
alice = Agent(name="alice")
Include a seed parameter when creating an agent to set a fixed address, for example from an environment variable:
import os
alice = Agent(name="alice", seed=os.getenv("ALICE_SEED_PHRASE"))
Otherwise the agent's private key will be stored locally alongside its name in private_keys.json.
If you create the agent without a name alice = Agent(), a new address will be generated each time you run the agent.
Giving it a task
Give it a simple task, such as a greeting:
@alice.on_interval(period=2.0)
async def say_hello(ctx: Context):
ctx.logger.info(f'hello, my name is {ctx.agent.name}')
if __name__ == "__main__":
alice.run()
Running the Agent
So far, your code should look like this:
from uagents import Agent, Context
alice = Agent(name="alice", seed="alice recovery phrase")
@alice.on_interval(period=2.0)
async def say_hello(ctx: Context):
ctx.logger.info(f'hello, my name is {ctx.agent.name}')
if __name__ == "__main__":
alice.run()
Run it using:
python agent.py
You should see the results in your terminal.
📖 Documentation
Please see the official documentation for full setup instructions and advanced features.
- 👋 Introduction
- 💻 Installation
- Tutorials
- Key Concepts:
🌱 Examples and Integrations
The uAgent-Examples repository contains several examples of how to create and run various types of agents as well as more intricate integrations. This is the official place for internal and community open source applications built on uAgents.
Python Library
Go to the python folder for details on the Python uAgents library.
uAgents Core
The uagents-core folder contains core definitions and functionalities to build 'agent' like software which can interact and integrate with Fetch.ai ecosystem and agent marketplace.
✨ Contributing
All contributions are welcome! Remember, contribution includes not only code, but any help with docs or issues raised by other developers. See our contribution guidelines for more details.
📄 Development Guidelines
Read our development guidelines to learn some useful tips related to development.
❓ Issues, Questions, and Discussions
We use GitHub Issues for tracking requests and bugs, and GitHub Discussions for general questions and discussion.
🛡 Disclaimer
This project, uAgents, is provided "as-is" without any warranty, express or implied. By using this software, you agree to assume all risks associated with its use, including but not limited to unexpected behavior, data loss, or any other issues that may arise. The developers and contributors of this project do not accept any responsibility or liability for any losses, damages, or other consequences that may occur as a result of using this software.
License
The uAgents project is licensed under Apache License 2.0.
3 maintainers
Metadata
3 maintainers
Release files for uagents 0.26.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| uagents-0.26.0.tar.gz | 973.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| uagents-0.26.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / uagents-0.26.0.tar.gz
| Download URL | uagents-0.26.0.tar.gz |
|---|---|
| Size | 973.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e4df8c7219e9b0913e54f671e135fd96230bf60f435169afea693f24f60735b0
|
|
BLAKE2b-256 checksum How to use checksums |
28841fe75e89d9bf9273c2c93ee8d64e879c94a2842cf610c8ed24f05e599fab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / uagents-0.26.0-py3-none-any.whl
| Download URL | uagents-0.26.0-py3-none-any.whl |
|---|---|
| Size | 89.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
402cd61a9a57b4525d139fac24191da71ba384a240db37ee4abe6b5d575bcf35
|
|
BLAKE2b-256 checksum How to use checksums |
abfcc7753cf95f73aaf09786fd8fd0ef3bb19faf2b93f9de8056dfd1fe8a28e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
