uAgents

In the Agentverse ↗ (opens in a new tab) Code Editor, you have the freedom to import and utilize a selected set of modules to create your code, while maintaining security and control. These pre-approved modules offer a diverse range of functionalities, allowing you to build complex agents.

The listed modules include:

• uagents: build fast and lightweight agents for decentralized scenarios using the μAgents framework. Checkout the μAgents ↗ documentation for more information.

  • Available classes: Model, Context, Protocol.

  Example:

  from uagents import Context, Model
   
  class Message(Model):
      text: str
   
  @agent.on_interval(period=2.0)
  async def print_message(ctx: Context):
      msg = Message(text=f"Hello there my wallet address is {ctx.wallet}.")
      print(msg.text)

• json: Seamlessly interact with JSON data structures.

  • Available functions: dumps, loads.

  Example:

  import json
   
  some_json =  '{ "agent":"Alice", "age":"1 day"}'
   
  # JSON to python dictionary
  python_dict = json.loads(some_json)
  print(python_dict["age"])
   
  # python dictionary to JSON:
  some_json_2 = json.dumps(python_dict)
   
  # the result is a JSON string equal to some_json:
  print(some_json_2)

• requests: Interact with HTTP requests and responses.

  • Available functions: get, post, put, patch, delete.

  Example:

  import requests
   
  response = requests.get('https://api.github.com')
  if response.status_code == 200:
      print('Success!')
  elif response.status_code == 404:
      print('Not Found.')
   
  print(response.headers)

• cosmpy: A Python library for interacting with Cosmos-based blockchains. Checkout CosmPy ↗ documentation for more information.

  • Full access to all functions and features.

  Example:

  from cosmpy import aerial
   
  # Define network configuration, faucet and ledger
  network = aerial.client.NetworkConfig.fetchai_stable_testnet()
  faucet_api = aerial.faucet.FaucetApi(network)
  ledger = aerial.client.LedgerClient(network)
   
  MINIMUM_BALANCE = 100000000000000000
   
  @agent.on_interval(period=20.0)
  async def get_tokens(ctx: Context):
   
      agent_balance = ledger.query_bank_balance(ctx.wallet)
   
      if agent_balance < MINIMUM_BALANCE:
          print("Providing wealth to agent...")
          faucet_api.get_wealth(ctx.wallet)

• datetime: Handle date and time operations with ease.

  • Full access to all functions and features.

  Example:

  import datetime
   
  today = datetime.datetime.now()
  print(f"Today is: {today.year}:{today.month}:{today.day}")

• enum: Create enumerations with symbolic names and unique values.

  • Full access to all functions and features.

  Example:

  from enum import Enum
   
  class Agent(Enum):
      alice = 1
      bob = 2
      carl = 3
   
  print(Agent.bob.value)

• pydantic: Ensure data validation and settings management.

  • Full access to all functions and features. Example:

  from pydantic import BaseModel
   
  data = {
      "name": "alice",
      "age": 21
  }
   
  class User(BaseModel):
      name: str
      age: int
   
  user = User(**data)
   
  print(user)

Multi-file Support:

The Agentverse Code Editor enhances your agent development experience with multi-file support, enabling you to tackle complex projects with ease. Leverage this feature to:

• Interact Between Files: seamlessly import functions, classes, and variables from one file to another.
• Modular Development: divide your projects into manageable components for streamlined creation.
• Code Reuse: utilize modules across various sections of your project for efficient development.
• Enhanced Organization: maintain a structured and organized codebase for easier maintenance.

To create new files you just need to click on + New File on Agentverse ↗ (opens in a new tab) inside your managed agent.

You can create a message Python file with the following Model:

from uagents import Model
 
class Sentence(Model):
    text: str

Then you can just import the Sentence data model to your agent.py file and make use of it:

from uagents import Context
from message import Sentence
 
@agent.on_interval(period=2.0)
async def print_message(ctx: Context):
    msg = Sentence(text=f"Hello there my wallet address is {ctx.wallet}.")
    print(msg.text)

Explore the resources at the Agentverse guides ↗ and Agentverse concepts ↗ for additional guides and documentation resources!