Agentkit

<div align="center"> <p> <a href="https://docs.cdp.coinbase.com/agentkit/docs/welcome"> <img src="./agentkit_banner.png"/> </a> </p> <h1 style="font-size: 3em; margin-bottom: 20px;"> AgentKit </h1> <p style="font-size: 1.2em; max-width: 600px; margin: 0 auto 20px;"> Every agent deserves a wallet. </p>

</div>

Table of Contents

• 📖 Overview
• 🚀 Quickstart
  • Node.js
  • Python
• 🗂 Repository Structure
• 🤝 Contributing
• 📜 Documentation
• 🌙 Nightly Builds
• 🚨 Security and Bug Reports
• 📧 Contact
• 🔗 Supported Wallets, Protocols, and Frameworks
• 📝 License
• 🔒 Legal and Privacy

📖 Overview

AgentKit is Coinbase Developer Platform's toolkit for giving AI agents a crypto wallet and onchain interactions. It is designed to be framework-agnostic, so you can use it with any AI framework, and wallet-agnostic, so you can use it with any wallet. With AgentKit, you can enable fee-free stablecoin payments and monetize your AI agents seamlessly. AgentKit is actively being built out, and welcomes community contributions!

<div align="center"> <a href="https://youtu.be/hw-PuogqLR0"> <img src="https://img.youtube.com/vi/hw-PuogqLR0/maxresdefault.jpg" alt="Video Title" style="max-width: 600px;"> <p align="center"> Watch our welcome guide above to understand what AgentKit is, learn how to navigate this repository, and get started building your first onchain AI agent. </p> </a> </div>

🚀 Quickstart

Node.js

Prerequisites:

• Node.js 22+
• CDP Secret API Key
• OpenAI API Key

1. Get your agent running:

# Create a new fullstack agent project
npm create onchain-agent@latest

# Navigate to your project directory
cd onchain-agent

# At this point, fill in your CDP API key id/secret, OpenAI API key, and any other environment variables in the .env.local file.
# Then, rename the .env.local file to .env
mv .env.local .env

# Install dependencies
npm install

# Run the development server
npm run dev

2. Visit http://localhost:3000 in your browser and start telling your Agent to do things onchain!

User: Fund my wallet with some testnet ETH.
Agent: Your wallet has been successfully funded with testnet ETH. You can view the transaction [here](https://sepolia.basescan.org/tx/0x03e82934cd04be5b725927729b517c606f6f744611f0f36e834f21ad742ad7ca)

Python

Prerequisites:

• Python 3.10+
• Poetry
• CDP Secret API Key
• OpenAI API Key

1. Get your agent running:

# Create a new agent chatbot
pipx run create-onchain-agent

# Navigate to your project directory
cd onchain-agent

# At this point, fill in your CDP API key id/secret, OpenAI API key, and any other environment variables in the .env.local file.
# Then, rename the .env.local file to .env
mv .env.local .env

# Install dependencies
poetry install

# Run the chatbot
poetry run python chatbot.py

2. Select "1. chat mode" and start telling your Agent to do things onchain!

Prompt: Fund my wallet with some testnet ETH.
-------------------
Wallet: ccaf1dbf-3a90-4e52-ad34-89a07aad9e8b on network: base-sepolia with default address: 0xD9b990c7b0079c1c3733D2918Ee50b68f29FCFD5
-------------------

-------------------
Received eth from the faucet. Transaction: https://sepolia.basescan.org/tx/0x03e82934cd04be5b725927729b517c606f6f744611f0f36e834f21ad742ad7ca
-------------------
Your wallet has been successfully funded with testnet ETH. You can view the transaction [here](https://sepolia.basescan.org/tx/0x03e82934cd04be5b725927729b517c606f6f744611f0f36e834f21ad742ad7ca).
-------------------

🗂 Repository Structure

AgentKit is organized as two monorepos, one for Python and one for Typescript, each containing multiple packages.

agentkit/
├── typescript/
│   ├── agentkit/
|   |   └── scripts/generate-action-provider/ # use this to create new actions
│   │   └── src/
│   │       ├── action-providers/ # find 50+ actions in here
│   │       └── wallet-providers/
│   │           ├── cdp/
│   │           ├── privy/
│   │           └── viem/
│   ├── create-onchain-agent/
│   ├── framework-extensions/
│   │   ├── langchain/
│   │   ├── vercel-ai-sdk/
│   │   └── model-context-protocol/
│   └── examples/
│       ├── langchain-cdp-chatbot/
│       ├── langchain-cdp-smart-wallet-chatbot/
│       ├── langchain-farcaster-chatbot/
│       ├── langchain-legacy-cdp-chatbot/
│       ├── langchain-privy-chatbot/
│       ├── langchain-solana-chatbot/
│       ├── langchain-twitter-chatbot/
│       ├── langchain-xmtp-chatbot/
│       ├── langchain-zerodev-chatbot/
│       ├── model-context-protocol-smart-wallet-server/
│       └── vercel-ai-sdk-smart-wallet-chatbot/
├── python/
│   ├── coinbase-agentkit/
│   │   └── coinbase_agentkit/
│   │       ├── action_providers/  # find 30+ actions in here
│   │       └── wallet_providers/
│   │           ├── cdp/
│   │           ├── privy/
│   │           └── viem/
│   ├── create-onchain-agent/
│   ├── framework-extensions/
│   │   ├── autogen/
│   │   ├── langchain/
│   │   ├── openai-agents-sdk/
│   │   ├── pydantic-ai/
│   │   └── strands-agents/
│   └── examples/
│       ├── autogen-cdp-chatbot/
│       ├── langchain-cdp-chatbot/
│       ├── langchain-cdp-smart-wallet-chatbot/
│       ├── langchain-cdp-solana-chatbot/
│       ├── langchain-eth-account-chatbot/
│       ├── langchain-nillion-secretvault-chatbot/
│       ├── langchain-twitter-chatbot/
│       ├── openai-agents-sdk-cdp-chatbot/
│       ├── openai-agents-sdk-cdp-voice-chatbot/
│       ├── openai-agents-sdk-smart-wallet-chatbot/
│       ├── pydantic-ai-cdp-chatbot/
│       └── strands-agents-cdp-server-chatbot/

🤝 Contributing

AgentKit is actively looking for community contributions!

• To see a list of actions and frameworks we'd love to see open-source contributions for, see WISHLIST.md.
• To understand the process for contributing to AgentKit, see CONTRIBUTING.md.

📜 Documentation

• AgentKit Documentation
• Python API References
  • AgentKit
  • AgentKit Langchain Extension
  • AgentKit OpenAI Agents SDK Extension
  • AgentKit Strands Agents Extension
• Node.js API References
  • AgentKit
  • AgentKit Langchain Extension
  • AgentKit Vercel AI SDK Extension
  • AgentKit Model Context Protocol Extension

🌙 Nightly Builds

To access the bleeding edge version of AgentKit, you can install the nightly build for your language. This is a build of the latest code in the main branch, and is updated nightly.

Typescript

You can install the latest nightly build with the following command:

npm install @coinbase/agentkit@nightly @coinbase/agentkit-langchain@nightly

If you're using an AI framework other than Langchain, make sure to install the corresponding package instead of @coinbase/agentkit-langchain.

To install a specific version of the nightly build, you can specify the exact version. For example, if you want to install the nightly build from February 20th, 2025, you can run the following:

npm install @coinbase/agentkit@0.2.3-nightly.20250220.0 @coinbase/agentkit-langchain@0.2.3-nightly.20250220.0

Python

You can install the latest nightly build with the following command:

pip install --pre coinbase-agentkit coinbase-agentkit-langchain

# or, using poetry
poetry add coinbase-agentkit coinbase-agentkit-langchain --allow-prereleases

If you're using an AI framework other than Langchain, make sure to install the corresponding package instead of coinbase-agentkit-langchain.

To install a specific version of the nightly build, you can specify the exact version. For example, if you want to install the nightly build from February 20th, 2025, you can run the following:

pip install coinbase-age