Hive Agent Kit

This library provides you with an easy way to create and run Hive Agents.

Project Requirements

• Python >= 3.11

Installation

You can either directly install from pip:

$ pip install git+https://github.com/hivenetwork-ai/hive-agent-py.git@main

Or add it to your requirements.txt file:

hive-agent @ git+https://github.com/hivenetwork-ai/hive-agent-py@main

Optional Dependencies

To install with the optional web3 dependencies, you can specify them as follows:

$ pip install git+https://github.com/hivenetwork-ai/hive-agent-py.git@main#egg=hive-agent[web3]

Or add it to your requirements.txt file:

hive-agent[web3] @ git+https://github.com/hivenetwork-ai/hive-agent-py@main

Environment Setup

You need to specify an OPENAI_API_KEY in a .env file in this directory.

Make a copy of the .env.example file and rename it to .env.

Usage

First import the HiveAgent class

from hive_agent import HiveAgent

Load your environment variables

from dotenv import load_dotenv
load_dotenv()

Then create a HiveAgent instance

my_agent = HiveAgent(
    name="my_agent",
    functions=[],
    instruction="your instructions for this agent's goal",
)

Then, run your agent:

my_agent.run()

Finally, call the API endpoint, /api/v1/chat, to see the result:

curl --location 'localhost:8000/api/v1/chat' \
--header 'Content-Type: application/json' \
--data '{ "messages": [{ "role": "user", "content": "Who is Satoshi Nakamoto?" }] }'

Adding tools

You can create tools that help your agent handle more complex tasks. Here's an example:

import os
from typing import Optional, Dict

from web3 import Web3
from hive_agent import HiveAgent

from dotenv import load_dotenv
load_dotenv()


rpc_url = os.getenv("RPC_URL") # add an ETH Mainnet HTTP RPC URL to your `.env` file


def get_transaction_receipt(transaction_hash: str) -> Optional[Dict]:
    """
    Fetches the receipt of a specified transaction on the Ethereum blockchain and returns it as a dictionary.

    :param transaction_hash: The hash of the transaction to fetch the receipt for.
    :return: A dictionary containing the transaction receipt details, or None if the transaction cannot be found.
    """
    web3 = Web3(Web3.HTTPProvider(rpc_url))

    if not web3.is_connected():
        print("unable to connect to Ethereum")
        return None

    try:
        transaction_receipt = web3.eth.get_transaction_receipt(transaction_hash)
        return dict(transaction_receipt)
    except Exception as e:
        print(f"an error occurred: {e}")
        return None


if __name__ == "__main__":
    my_agent = HiveAgent(
        name="my_agent",
        functions=[get_transaction_receipt]
    )
    
    my_agent.run()

    """
    [1] send a request:
    
    ```
    curl --location 'localhost:8000/api/v1/chat' \
    --header 'Content-Type: application/json' \
    --data '{ "messages": [{ "role": "user", "content": "Which address initiated this transaction - 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060?" }] }'
    ```
    
    
    [2] result:
    
    The address that initiated the transaction with hash 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060 is 0xA1E4380A3B1f749673E270229993eE55F35663b4.
    """

Tutorial

The complete tutorial can be found at ./tutorial.md.

Contributing

Setup

If you want to contribute to the codebase, you would need to setup your dev environment. Follow these steps:

• Create a new file called .env
• Copy the contents of .env.example into your new .env file
• API keys for third party tools are not provided.
  • OPENAI_API_KEY from OpenAI
• If you don't have Poetry installed, you can install it using the following commands:

$ curl -sSL https://install.python-poetry.org | python3 -

$ export PATH="$HOME/.local/bin:$PATH" 

• Activate the Virtual Environment created by Poetry with the following command:

$ poetry shell

• Install dependencies.

$ poetry install --no-root

Testing

• Run the test suite

$ pytest

• Run tests for a specific module

$ pytest tests/path/to/test_module.py

• Run with verbose output:

$ pytest -v

• Run with a detailed output of each test (including print statements):

$ pytest -s

API Doc

Open http://localhost:8000/docs with your browser to see the Swagger UI of the API.

Learn More

https://hivenetwork.ai