Creating your first agent

Introduction

Once you've installed the uAgents library, it's quite simple to get a minimal use case running.

The uAgents Framework simplifies Agents creation, and enables Agents communication, discovery, and publication on the Fetch.ai network. The Framework supports building Agents using anything from advanced Large Language Models (LLMs) to basic APIs.

Let's start with a simple Agent that initializes and prints its name and address

Prerequisites

Make sure you have read the following resources before going on with this guide:

• Quick Start Guide for uAgents Framework
• Agents address

Imports needed

• uAgents (opens in a new tab)

The agent

1. Let's create a Python script for this task, and name it by running:

   windows
   echo. > first_agent.py

2. We then need to import the Agent and Context classes from the uagents library, and then create an agent using the class Agent:

first_agent.py
 
from uagents import Agent, Context
 
agent = Agent(name="alice", seed="secret_seed_phrase", port=8000, endpoint=["http://localhost:8000/submit"])
 

It is optional but useful to include a seed parameter when creating an agent to set fixed addresses . Otherwise, random addresses will be generated every time you run the agent. Your address is kind of important, as this is how other agents will identify you.

3. Let's define a say_hello() function for our agent to print a message periodically saying hello, my name is ...:

first_agent.py
 
@agent.on_event("startup")
async def introduce_agent(ctx: Context):
    ctx.logger.info(f"Hello, I'm agent {agent.name} and my address is {agent.address}.")
 
if __name__ == "__main__":
    agent.run()
 

The .on_event("startup") decorator defines a behavior for this agent when it is run. In this case, the agent will execute the say_hello() function when the agent starts. The Context object is a collection of data and functions related to the agent. In this case, we just use the agent's name, alice. The agent executes the function and uses the ctx.logger.info() method to print the message.

4. Save the script.

The overall script should look as follows:

first_agent.py
 
from uagents import Agent, Context
 
agent = Agent(name="alice", seed="secret_seed_phrase", port=8000, endpoint=["http://localhost:8000/submit"])
 
@agent.on_event("startup")
async def introduce_agent(ctx: Context):
    ctx.logger.info(f"Hello, I'm agent {agent.name} and my address is {agent.address}.")
 
if __name__ == "__main__":
    agent.run()
 

Run your agent

Make sure to have activated your virtual environment correctly.

Run the script: python first_agent.py

The output would be:

INFO:     [alice]: Registration on Almanac API successful
INFO:     [alice]: Registering on almanac contract...
INFO:     [alice]: Registering on almanac contract...complete
INFO:     [alice]: Agent inspector available at https://agentverse.ai/inspect/?uri=http%3A//127.0.0.1%3A8000&address=agent1qtu6wt5jphhmdjau0hdhc002ashzjnueqe89gvvuln8mawm3m0xrwmn9a76
INFO:     [alice]: Starting server on http://0.0.0.0:8000 (Press CTRL+C to quit)
INFO:     [alice]: Hello, I'm agent alice and my address is agent1qtu6wt5jphhmdjau0hdhc002ashzjnueqe89gvvuln8mawm3m0xrwmn9a76.

Congratulations, you have just created your first Agent!