https://github.com/coinbase/agentkit
Every AI Agent deserves a wallet.
https://github.com/coinbase/agentkit
Last synced: 12 months ago
JSON representation
Every AI Agent deserves a wallet.
- Host: GitHub
- URL: https://github.com/coinbase/agentkit
- Owner: coinbase
- License: other
- Created: 2024-10-31T20:40:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-09T19:26:39.000Z (about 1 year ago)
- Last Synced: 2025-05-09T20:29:23.763Z (about 1 year ago)
- Language: TypeScript
- Homepage: https://docs.cdp.coinbase.com/agentkit/docs/welcome
- Size: 9.21 MB
- Stars: 703
- Watchers: 15
- Forks: 421
- Open Issues: 86
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING-PYTHON.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-blockrun - AgentKit
- awesome-finance-mcp - Coinbase MCP
- awesome-agents - Coinbase AgentKit - Toolkit for building AI agents with onchain capabilities and wallet management. (Frameworks)
- awesome-mcp-servers - Coinbase MCP
- awesome-ccamel - coinbase/agentkit - Every AI Agent deserves a wallet. (TypeScript)
- awesome-web3-ai - AgentKit - chain AI agents. | (🤖 AI Agent Frameworks)
- awesome-agent-cortex - Coinbase AgentKit - Toolkit for giving AI agents programmable wallet capabilities. (Agent Identity and Wallets / Benchmark Reality Check (real-world tool use))
README
AgentKit
Every agent deserves a wallet.
[](https://github.com/coinbase/agentkit/actions/workflows/github-code-scanning/codeql)
[](https://pypistats.org/packages/coinbase-agentkit)
[](https://www.npmjs.com/package/@coinbase/agentkit)
[](https://star-history.com/#coinbase/agentkit)
[](https://github.com/coinbase/agentkit/issues)
## Table of Contents
- [📖 Overview](#-overview)
- [🚀 Quickstart](#-quickstart)
- [Node.js](#nodejs)
- [Python](#python)
- [🗂 Repository Structure](#-repository-structure)
- [🤝 Contributing](#-contributing)
- [📜 Documentation](#-documentation)
- [🌙 Nightly Builds](#-nightly-builds)
- [🚨 Security and bug reports](#-security-and-bug-reports)
- [📧 Contact](#-contact)
- [🔗 Supported Wallets, Protocols, and Frameworks](#-supported-wallets-protocols-and-frameworks)
- [📝 License](#-license)
- [🔒 Legal and Privacy](#-legal-and-privacy)
## 📖 Overview
AgentKit is [Coinbase Developer Platform's](https://docs.cdp.coinbase.com) 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!](#-contributing)
## 🚀 Quickstart
### Node.js
_Prerequisites_:
- [Node.js 18+](https://nodejs.org/en/download/)
- [CDP Secret API Key](https://docs.cdp.coinbase.com/get-started/docs/cdp-api-keys#creating-secret-api-keys)
- [OpenAI API Key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key)
1. Get your agent running:
```bash
# 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 name, 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!
```bash
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+](https://www.python.org/downloads/)
- [Poetry](https://python-poetry.org/docs/)
- [CDP Secret API Key](https://docs.cdp.coinbase.com/get-started/docs/cdp-api-keys#creating-secret-api-keys)
- [OpenAI API Key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key)
1. Get your agent running:
```bash
# 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 name, 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!
```bash
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/
│ │ └── src/
│ │ ├── action-providers/ # find 50+ actions in here
│ │ └── wallet-providers/
│ │ ├── cdp/
│ │ ├── privy/
│ │ └── viem/
│ │ └── scripts/generate-action-provider/ # use this to create new actions
│ ├── create-onchain-agent/
│ ├── framework-extensions/
│ │ ├── langchain/
│ │ ├── vercel-ai-sdk/
│ │ └── model-context-protocol/
│ └── examples/
│ ├── langchain-cdp-chatbot/
│ ├── langchain-cdp-v2-chatbot/
│ ├── langchain-farcaster-chatbot/
│ ├── langchain-privy-chatbot/
│ ├── langchain-solana-chatbot/
│ ├── langchain-twitter-chatbot/
│ ├── langchain-xmtp-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/
│ │ ├── langchain/
│ │ └── openai-agents-sdk/
│ └── examples/
│ ├── langchain-cdp-chatbot/
│ ├── langchain-eth-account-chatbot/
│ ├── langchain-smart-wallet-chatbot/
│ ├── langchain-twitter-chatbot/
│ └── openai-agents-cdp-voice-chatbot/
│ └── openai-agents-sdk-smart-wallet-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](./WISHLIST.md).
- To understand the process for contributing to AgentKit, see [CONTRIBUTING.md](./CONTRIBUTING.md).
## 📜 Documentation
- [AgentKit Documentation](https://docs.cdp.coinbase.com/agentkit/docs/welcome)
- Python API References
- [AgentKit](https://coinbase.github.io/agentkit/coinbase-agentkit/python/index.html)
- [AgentKit Langchain Extension](https://coinbase.github.io/agentkit/coinbase-agentkit-langchain/python/index.html)
- Node.js API References
- [AgentKit](https://coinbase.github.io/agentkit/agentkit/typescript/index.html)
- [AgentKit Langchain Extension](https://coinbase.github.io/agentkit/agentkit-langchain/typescript/index.html)
- [AgentKit Vercel AI SDK Extension](https://coinbase.github.io/agentkit/agentkit-vercel-ai-sdk/typescript/index.html)
- [AgentKit Model Context Protocol Extension](https://coinbase.github.io/agentkit/agentkit-model-context-protocol/typescript/index.html)
## 🌙 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:
```bash
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:
```bash
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:
```bash
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:
```bash
pip install coinbase-agentkit==0.1.2.dev20250220 coinbase-agentkit-langchain==0.1.1.dev20250220
# or, using poetry
poetry add coinbase-agentkit==0.1.2.dev20250220 coinbase-agentkit-langchain==0.1.1.dev20250220 --allow-prereleases
```
## 🚨 Security and Bug Reports
The AgentKit team takes security seriously.
See [SECURITY.md](SECURITY.md) for more information.
## 📧 Contact
For feature requests, feedback, or questions, please reach out to us via the
[Coinbase Developer Platform Discord](https://discord.com/channels/1220414409550336183/1304126107876069376).
## 🔗 Supported Wallets, Protocols, and Frameworks
AgentKit is proud to have support for the following protocols, frameworks, wallets and networks. For detailed documentation on supported providers, see:
- [Action Providers (TypeScript)](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/action-providers)
- [Action Providers (Python)](https://github.com/coinbase/agentkit/blob/main/python/coinbase-agentkit/coinbase_agentkit/action_providers)
- [Wallet Providers (TypeScript)](https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/src/wallet-providers)
- [Wallet Providers (Python)](https://github.com/coinbase/agentkit/blob/main/python/coinbase-agentkit/coinbase_agentkit/wallet_providers)
### Wallets
### Protocols
### Frameworks
### Networks
Note: We support all EVM and SVM networks, with deep protocol support for the above networks. Please don't hesitate to make contributions to add more support for your preferred networks.
## 📝 License
AgentKit is licensed under the [Apache-2.0](LICENSE.md) license.
## 🔒 Legal and Privacy
The AgentKit software is novel and experimental, and is therefore provided on an AS-IS basis. The software is intended to be used only for the purposes of assisting with designing blockchain transactions and enabling other API integrations using natural language inputs, and is not intended to provide (i) an offer, or solicitation of an offer, to invest in, or to buy or sell, any interests or shares, or to participate in any investment or trading strategy, (ii) accounting, legal, tax advice, investment recommendations or other professional advice or (iii) an official statement of Coinbase. Acts proposed or performed by an agent through AgentKit software are NOT acts of Coinbase. You should consult with a professional advisor before making any decisions based on the information provided by the software. You are not permitted to use the proceeds of loans or credit to purchase digital assets on or through coinbase.com, Coinbase's APIs, the Coinbase mobile application, or any other Coinbase website or product, including AgentKit. No representation or warranty is made, expressed or implied, with respect to the accuracy, completeness, reliability, security, or suitability of the software or to any information provided in connection with the software. The risk of loss through use of the software can be substantial, and you assume any and all risks of loss and liability. The software may produce output that is inaccurate, incorrect, unpredictable or undesirable, and it is the user’s exclusive responsibility to evaluate the output and the use-case and determine whether it is appropriate. The right to use the software is contingent on your agreement to the [CDP Terms of Service](https://www.coinbase.com/legal/developer-platform/terms-of-service) (except to the extent it conflicts with the Apache-2.0 license).
