> ## 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.

# Hedera AI Agent Kit

> Build LLM-powered applications that interact with the Hedera Network

<Note>
  **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](/solutions/ai/agent-kit/js/quickstart) and [Plugins](/solutions/ai/agent-kit/plugins) pages for updated setup instructions.
  You can also see the [Migration Guide](/solutions/ai/agent-kit/js/migration-guide) for more details.
</Note>

## 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:

<CardGroup cols={2}>
  <Card title="JavaScript SDK" icon="js" href="/solutions/ai/agent-kit/js/quickstart">
    Build with TypeScript/JavaScript using npm
  </Card>

  <Card title="Python SDK" icon="python" href="/solutions/ai/agent-kit/python/quickstart">
    Build with Python using pip
  </Card>

  <Card title="Agent Lab" icon="code" href="https://portal.hedera.com/agent-lab#code">
    Write and run agent code in Hedera’s developer portal
  </Card>

  <Card title="Agent Builder" icon="wrench" href="https://portal.hedera.com/agent-lab#build">
    Build agents with a guided workflow in Hedera’s developer portal
  </Card>
</CardGroup>

***

## 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)](https://modelcontextprotocol.io/). It operates strictly in `RETURN_BYTES` mode.

[Learn more about the Hosted MCP Server →](/solutions/ai/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?**

| 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

[Get Started with JavaScript →](/solutions/ai/agent-kit/js/quickstart)

### Python

Best for:

* Data science and ML workflows
* Python backend services
* Jupyter notebooks and scripting

[Get Started with Python →](/solutions/ai/agent-kit/python/quickstart)

***

## Resources

| Resource    | JavaScript                                                               | Python                                                                   |
| ----------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| **GitHub**  | [hedera-agent-kit-js](https://github.com/hashgraph/hedera-agent-kit-js)  | [hedera-agent-kit-py](https://github.com/hashgraph/hedera-agent-kit-py)  |
| **Package** | [npm](https://www.npmjs.com/package/@hashgraph/hedera-agent-kit)         | [PyPI](https://pypi.org/project/hedera-agent-kit/)                       |
| **Issues**  | [GitHub Issues](https://github.com/hashgraph/hedera-agent-kit-js/issues) | [GitHub Issues](https://github.com/hashgraph/hedera-agent-kit-py/issues) |

***

## Requests and Contributions

**To request additional functionality**, please open an issue in the [JavaScript SDK](https://github.com/hashgraph/hedera-agent-kit-js) or [Python SDK](https://github.com/hashgraph/hedera-agent-kit-py) Hedera Agent Kit GitHub repository.

**To contribute**, see the contributing guidelines in each repository.

**Need help?** Reach out in the [Hedera Discord](https://hedera.com/discord) in the **Support > developer-help-desk** channel.