v4 Breaking Changes (JavaScript SDK): The package has moved to the
@hashgraph scope, framework integrations are now separate packages, and plugins must be explicitly imported from @hashgraph/hedera-agent-kit/plugins. See the JavaScript Quickstart and Plugins pages for updated setup instructions.
You can also see the Migration Guide for more details.Overview
The Hedera Agent Kit is an open-source framework for building AI-powered applications that interact with the Hedera Network. Create conversational agents that understand natural language and execute Hedera transactions, or build backend systems that leverage AI for on-chain operations. The Agent Kit is available in two languages and provides different tools:JavaScript SDK
Build with TypeScript/JavaScript using npm
Python SDK
Build with Python using pip
Agent Lab
Write and run agent code in Hedera’s developer portal
Agent Builder
Build agents with a guided workflow in Hedera’s developer portal
Hedera Agent Kit JavaScript Packages
The JavaScript Agent Kit ships as a core package with separate framework toolkit packages. Plugins are imported from the@hashgraph/hedera-agent-kit/plugins subpath.
Which packages do I need?
| Package | Purpose |
|---|---|
@hashgraph/hedera-agent-kit | Core types, AgentMode, Plugin, Tool, HederaBuilder |
@hashgraph/hedera-agent-kit/plugins | All built-in Hedera plugins (subpath of core) |
@hashgraph/hedera-agent-kit/hooks | Hook base classes and built-in hooks (subpath of core) |
@hashgraph/hedera-agent-kit/policies | Policy base classes and built-in policies (subpath of core) |
@hashgraph/hedera-agent-kit-langchain | LangChain toolkit (HederaLangchainToolkit) |
@hashgraph/hedera-agent-kit-ai-sdk | Vercel AI SDK toolkit (HederaAIToolkit) |
@hashgraph/hedera-agent-kit-adk | Google ADK toolkit (HederaADKToolkit) |
@hashgraph/hedera-agent-kit-elizaos | ElizaOS toolkit (HederaElizaOSToolkit) |
@hashgraph/hedera-agent-kit-mcp | MCP toolkit (HederaMCPToolkit) |
Key Features
Both SDKs provide:- 🔌 Plugin Architecture: Extensible design for easy customization
- 🧠 LangChain Integration: Support for LangChain v1 and LangChain Classic
- 🧠 ADK Integration: Support for Google ADK
- 🛡️ Hooks and Policies: Enforce business logic and security rules
- 🪙 Comprehensive Hedera Tools:
- Token creation and management (HTS)
- Smart contract execution (EVM)
- Account operations
- Topic (HCS) creation and messaging
- Transaction scheduling
- Allowances and approvals
SDK Comparison
| Feature | JavaScript SDK | Python SDK |
|---|---|---|
| Package Manager | npm | pip |
| Package Name | @hashgraph/hedera-agent-kit | hedera-agent-kit |
| Hedera SDK | @hiero-ledger/sdk | hiero_sdk_python |
| AUTONOMOUS Mode | ✅ Supported | ✅ Supported |
| LangChain v1 | ✅ Supported | ✅ Supported |
| LangChain Classic | ✅ Supported | ✅ Supported |
| Vercel AI SDK | ✅ Supported | ❌ Not Available |
| Google ADK | ✅ Supported | ✅ Supported |
| RETURN_BYTES Mode | ✅ Supported | ✅ Supported |
| ElizaOS Integration | ✅ Supported | ❌ Not Available |
| MCP Server | ✅ Supported | ✅ Coming Soon |
| Hooks & Policies | ✅ Supported | ✅ Supported |
Available Plugins
Both SDKs provide the same core functionality through plugins:| Plugin | Description |
|---|---|
| Core Account Plugin | Transfer HBAR, create/update/delete accounts, manage allowances |
| Core Account Query Plugin | Query account info, balances, token holdings |
| Core Consensus Plugin | Create topics, submit messages (HCS) |
| Core Consensus Query Plugin | Query topic info and messages |
| Core Token Plugin | Create/mint/transfer fungible and non-fungible tokens (HTS) |
| Core Token Query Plugin | Query token info and pending airdrops |
| Core EVM Plugin | Deploy and interact with ERC-20 and ERC-721 contracts |
| Core EVM Query Plugin | Query ERC-20 / ERC-721 contract data |
| Core Transaction Query Plugin | Query transaction records |
| Core Misc Query Plugin | Exchange rates and other utilities |
Choose Your SDK
JavaScript/TypeScript
Best for:- Web applications
- Node.js backends
- Full feature set including ElizaOS
Python
Best for:- Data science and ML workflows
- Python backend services
- Jupyter notebooks and scripting
Resources
| Resource | JavaScript | Python |
|---|---|---|
| GitHub | hedera-agent-kit-js | hedera-agent-kit-py |
| Package | npm | PyPI |
| Issues | GitHub Issues | GitHub Issues |