Skip to main content
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

​
Hosted MCP Server

The Hashgraph Hosted MCP Server provides a managed, remote instance of the Hedera Agent Kit exposing its tools via the Model Context Protocol (MCP). It operates strictly in RETURN_BYTES mode. Learn more about the Hosted MCP Server →

​
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?

​
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

​
Available Plugins

Both SDKs provide the same core functionality through plugins:

​
Choose Your SDK

​
JavaScript/TypeScript

Best for:
  • Web applications
  • Node.js backends
  • Full feature set including ElizaOS
Get Started with JavaScript →

​
Python

Best for:
  • Data science and ML workflows
  • Python backend services
  • Jupyter notebooks and scripting
Get Started with Python →

​
Resources

​
Requests and Contributions

To request additional functionality, please open an issue in the JavaScript SDK or Python SDK Hedera Agent Kit GitHub repository. To contribute, see the contributing guidelines in each repository. Need help? Reach out in the Hedera Discord in the Support > developer-help-desk channel.