Hero Light

​
What is ICP Agent Kit?

ICP Agent Kit is a comprehensive TypeScript library that enables natural language interaction with the Internet Computer Protocol (ICP) blockchain ecosystem. Built with LangChain integration in mind, it provides both direct API methods and natural language processing capabilities for ICP-related operations.

​
Key Features

Natural Language Processing

Chat with the ICP blockchain using natural language commands powered by LangChain and OpenAI.

Complete Plugin Suite

Four core plugins: Identity, Token, Canister, and Cycles management with full API coverage.

10 LangChain Tools

Pre-built tools for all blockchain operations: transfers, deployments, balance checks, and more.

Specialized Agents

Purpose-built agents for DeFi operations, canister development, and general blockchain tasks.

​
Quick Examples

import { ICPAgent } from 'icp-agent-kit';

// Initialize with OpenAI for natural language
const agent = new ICPAgent({ 
  network: 'mainnet',
  openai: { apiKey: process.env.OPENAI_API_KEY }
});
await agent.initialize();

// Use natural language commands
await agent.processNaturalLanguage('Check my ICP balance');
await agent.processNaturalLanguage('Transfer 5 ICP to alice.icp');
await agent.processNaturalLanguage('Create a new canister with 2T cycles');

// Or use specialized agents
const defiAgent = agent.createAgent('defi');
await defiAgent.chat('Show me all my token balances');

​
Features

Production Ready: Comprehensive TypeScript library for ICP blockchain interaction🔧 Core Plugins:
  • Identity: Seed phrases, anonymous identities, switching, and management
  • Token: ICP transfers, ICRC-1/2 support, balance queries, metadata
  • Canister: Create, deploy, upgrade, call methods, manage controllers
  • Cycles: Monitor, top-up, convert ICP, forecasting, auto-management
🤖 AI Integration:
  • 10 pre-built LangChain tools covering all operations
  • Natural language processing via OpenAI GPT-4
  • 4 specialized agent templates (DeFi, Developer, General, Governance)
  • Context-aware conversations with session management
📚 Examples & Resources:
  • Production-ready sample applications
  • Comprehensive TypeScript documentation
  • Real-world usage patterns and best practices
  • Complete test coverage and reliability

​
Key Capabilities

1

🔐 Identity Management

Complete identity system with seed phrases, anonymous identities, and secure switching.
2

💰 Token Operations

Full ICP and ICRC-1/2 token support with transfers, balance queries, and metadata.
3

🚀 Canister Management

Deploy, upgrade, and interact with canisters using both direct API and natural language.
4

⚡ Cycles Management

Monitor, top-up, and automate cycles management with forecasting and alerts.
5

🤖 AI Integration

Natural language processing with specialized agents for different blockchain tasks.

​
Why ICP Agent Kit?

​
Get Started

Ready to start building with ICP Agent Kit? Follow our quickstart guide to set up your first project in minutes.

View on GitHub

Explore the source code, contribute, or report issues on GitHub.