Overview
Build LLM-powered applications that interact with the Hedera Network. Create conversational agents that can understand user requests in natural language and execute Hedera transactions, or build backend systems that leverage AI for on-chain operations. The Hedera Agent Kit provides:- Conversational AI: LangChain-based agents that understand natural language
- Adaptors for Framework Tools: Pre-built tools covering Hedera services (and third party plugins), automatically adapted into popular frameworks like LangChain, Vercel ai-sdk, and MCP
- Flexible Transaction Handling: Direct execution or provide transaction bytes for user signing
- Autonomous and Human-in-the-Loop mode for executing transactions on Hedera
- A Plugin Architecture - For using both Hedera network capabilities and services, as well as third-party features and functionality
Quick Start - Create a Hedera Agent
See the npm package for the Hedera Agent Kit can be found at: https://www.npmjs.com/package/hedera-agent-kit- Create your project directory
- Install the agent kit, and init the project
-
Install ONE of these AI provider packages:
- Add Environment Variables
- Once you have your project set up, create an index.js file:
index.js
- Run Your “Hello Hedera Agent Kit” Example
Examples
See and try out the example NextJS Application built using the latest version of the AI Agent Kit to see Clone and try out different examples in the toolkit:- The example tool calling agent can carry out simple tasks with Hedera tools in ‘autonomous mode’
- The structured chat agent can string together and complete more complex tasks, autonomously on Hedera
- The human in the loop agent shows you how you can create a more controlled workflow
- Try out the MCP server to enable interaction with Hedera in your favorite application such as Claude Desktop or an IDE like Cursor.
About the Agent Kit
Agent Execution Modes
This tool has two execution modes with AI agents; autonomous excution and return bytes. If you set:mode: AgentMode.RETURN_BYTEthe transaction will be executed, and the bytes to execute the Hedera transaction will be returned.mode: AgentMode.AUTONOMOUSthe transaction will be executed autonomously, using the accountID set (the operator account can be set in the client with.setOperator(process.env.ACCOUNT_ID!)
Agent Kit Plugins
The Hedera Agent Kit provides a basic set of tools in the form of Plugins, which group together sets of functionality and can easily be included in your instance of hederaAgentToolkit Need additional capabilities with the agent kit, that isn’t currently included? Please open an issue. Available Plugins- Core Account Plugin: Tools for Hedera Account Service operations
- Core Consensus Plugin: Tools for Hedera Consensus Service (HCS) operations
- Core HTS Plugin: Tools for Hedera Token Service operations
- Core Queries Plugin: Tools for querying Hedera network data
Requests and Contributions
To request additional functionality, please open an issue.To contribute to the Hedera Agent Kit see the Contributing Guidelines
To create your own plugin, see the instructions in PLUGINS.md
To officially register your plugin, follow the instructions here