> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hedera.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugins (Python)

> Plugin architecture and available tools for the Python SDK

## Summary

The Hedera Agent Kit provides a comprehensive set of tools organized into **plugins**, which extend the functionality of the Hedera Agent Kit SDK. These tools can be used both by the conversational agent and when you are building with the SDK.

See the full plugin documentation: [HEDERAPLUGINS.md](https://github.com/hashgraph/hedera-agent-kit-py/blob/main/docs/HEDERAPLUGINS.md)

***

## Plugin Architecture

The tools are organized into plugins, each containing related functionality:

* **core\_account\_plugin**: Tools for Hedera Account Service operations
* **core\_account\_query\_plugin**: Tools for querying Hedera Account Service data
* **core\_consensus\_plugin**: Tools for Hedera Consensus Service (HCS) operations
* **core\_consensus\_query\_plugin**: Tools for querying HCS data
* **core\_token\_plugin**: Tools for Hedera Token Service (HTS) operations
* **core\_token\_query\_plugin**: Tools for querying HTS data
* **core\_evm\_plugin**: Tools for interacting with EVM smart contracts (ERC-20, ERC-721)
* **core\_misc\_query\_plugin**: Tools for miscellaneous queries
* **core\_transaction\_query\_plugin**: Tools for transaction-related queries

***

## Available Plugins and Tools

### Core Account Plugin (`core_account_plugin`)

Tools for Hedera **Account Service operations**:

| Tool Name                               | Description                        |
| --------------------------------------- | ---------------------------------- |
| `TRANSFER_HBAR_TOOL`                    | Transfer HBAR between accounts     |
| `APPROVE_HBAR_ALLOWANCE_TOOL`           | Approve an HBAR spending allowance |
| `DELETE_HBAR_ALLOWANCE_TOOL`            | Delete an HBAR allowance           |
| `TRANSFER_HBAR_WITH_ALLOWANCE_TOOL`     | Transfer HBAR using an allowance   |
| `CREATE_ACCOUNT_TOOL`                   | Create a new Hedera account        |
| `UPDATE_ACCOUNT_TOOL`                   | Update an account's metadata       |
| `DELETE_ACCOUNT_TOOL`                   | Delete an account                  |
| `SCHEDULE_DELETE_TOOL`                  | Delete a scheduled transaction     |
| `APPROVE_FUNGIBLE_TOKEN_ALLOWANCE_TOOL` | Approve token spending allowances  |
| `APPROVE_NFT_ALLOWANCE_TOOL`            | Approve NFT allowances             |

***

### Core Account Query Plugin (`core_account_query_plugin`)

Tools for querying **Account Service** data:

| Tool Name                               | Description                               |
| --------------------------------------- | ----------------------------------------- |
| `GET_ACCOUNT_QUERY_TOOL`                | Returns comprehensive account information |
| `GET_HBAR_BALANCE_QUERY_TOOL`           | Returns the HBAR balance for an account   |
| `GET_ACCOUNT_TOKEN_BALANCES_QUERY_TOOL` | Returns token balances for an account     |

***

### Core Consensus Plugin (`core_consensus_plugin`)

Tools for **Consensus Service (HCS)** operations:

| Tool Name                   | Description                 |
| --------------------------- | --------------------------- |
| `CREATE_TOPIC_TOOL`         | Create a new topic          |
| `SUBMIT_TOPIC_MESSAGE_TOOL` | Submit a message to a topic |
| `DELETE_TOPIC_TOOL`         | Delete a topic              |
| `UPDATE_TOPIC_TOOL`         | Update a topic              |

***

### Core Token Plugin (`core_token_plugin`)

Tools for **Token Service (HTS)** operations:

| Tool Name                                     | Description                        |
| --------------------------------------------- | ---------------------------------- |
| `CREATE_FUNGIBLE_TOKEN_TOOL`                  | Creates a fungible token           |
| `CREATE_NON_FUNGIBLE_TOKEN_TOOL`              | Creates an NFT collection          |
| `MINT_FUNGIBLE_TOKEN_TOOL`                    | Mints additional fungible tokens   |
| `MINT_NON_FUNGIBLE_TOKEN_TOOL`                | Mints NFTs with metadata           |
| `ASSOCIATE_TOKEN_TOOL`                        | Associates tokens with an account  |
| `DISSOCIATE_TOKEN_TOOL`                       | Dissociates tokens from an account |
| `AIRDROP_FUNGIBLE_TOKEN_TOOL`                 | Airdrops tokens to recipients      |
| `TRANSFER_FUNGIBLE_TOKEN_WITH_ALLOWANCE_TOOL` | Transfers tokens using allowance   |

***

### Core EVM Plugin (`core_evm_plugin`)

Tools for **EVM smart contract** operations:

| Tool Name              | Description                |
| ---------------------- | -------------------------- |
| `CREATE_ERC20_TOOL`    | Deploys an ERC-20 token    |
| `TRANSFER_ERC20_TOOL`  | Transfers an ERC-20 token  |
| `CREATE_ERC721_TOOL`   | Deploys an ERC-721 token   |
| `MINT_ERC721_TOOL`     | Mints an ERC-721 token     |
| `TRANSFER_ERC721_TOOL` | Transfers an ERC-721 token |

***

## Using Hedera Plugins in Python

First, import the plugins you need:

```python theme={null}
from hedera_agent_kit.plugins import (
    core_account_plugin,
    core_account_query_plugin,
    core_consensus_plugin,
    core_token_plugin,
    core_evm_plugin,
)
from hedera_agent_kit.shared.configuration import AgentMode, Context, Configuration
```

Then instantiate the toolkit with your configuration:

```python theme={null}
from hedera_agent_kit.langchain.toolkit import HederaLangchainToolkit

configuration = Configuration(
    tools=[],  # Empty = load all tools from plugins
    context=Context(
        mode=AgentMode.AUTONOMOUS,
        account_id=str(operator_id),
    ),
    plugins=[
        core_account_plugin,
        core_account_query_plugin,
        core_consensus_plugin,
        core_token_plugin,
        core_evm_plugin,
    ],
)

hedera_toolkit = HederaLangchainToolkit(
    client=client,
    configuration=configuration,
)

# Get the tools for use with LangChain
tools = hedera_toolkit.get_tools()
```

***

## Agent Modes

The Python SDK currently supports one agent mode:

| Mode                   | Description                                                    |
| ---------------------- | -------------------------------------------------------------- |
| `AgentMode.AUTONOMOUS` | The agent executes transactions directly on the Hedera network |

> **Coming Soon:** `AgentMode.RETURN_BYTES` - In this mode, the agent creates the transaction and returns the bytes for the user to execute.

***

## Resources

* **GitHub**: [https://github.com/hashgraph/hedera-agent-kit-py](https://github.com/hashgraph/hedera-agent-kit-py)
* **Plugins Documentation**: [HEDERAPLUGINS.md](https://github.com/hashgraph/hedera-agent-kit-py/blob/main/docs/HEDERAPLUGINS.md)
* **Tools Documentation**: [HEDERATOOLS.md](https://github.com/hashgraph/hedera-agent-kit-py/blob/main/docs/HEDERATOOLS.md)