# create-onchain-agent
## Overview
`create-onchain-agent` is a CLI tool powered by [AgentKit](https://github.com/coinbase/agentkit) that allows developers to quickly scaffold an **onchain agent** project. This tool simplifies the setup process by generating a chatbot with predefined configurations, including blockchain network selection and wallet providers.
## Requirements
To use `create-onchain-agent`, you must first setup:
- **Python**: [Install Python](https://realpython.com/installing-python/) version 3.10 or 3.11
- **Pipx**: [Install pipx](https://pipx.pypa.io/stable/installation/) using Python version 3.10 or 3.11
**NOTE:** If you have multiple versions of Python installed, you can specify the Python version when installing pipx.
e.g.:
```sh
python3.10 -m pip install --user pipx
python3.10 -m pipx ensurepath
```
## Usage
To use `create-onchain-agent`, simply run:
```sh
pipx run create-onchain-agent
```
This command will guide you through setting up an onchain agent project by prompting for necessary configuration options.
### Beginner Mode
If you are a beginner to web3 agents, we recommend running the command with the `beginner` flag:
```sh
pipx run create-onchain-agent --beginner
```
This will create a simplified chatbot with our recommended configurations, so you can get started quickly, without having to worry about the underlying details.
## Features
- **Guided setup**: Interactive prompts help configure the project.
- **Supports multiple agent frameworks**.
- **Supports multiple blockchain networks**.
- **Select your preferred wallet provider**.
- **Automates environment setup**.
### Setup Process
The CLI will prompt you for the following details:
1. **Project Name**: The name of your new onchain agent project.
2. **Package Name**: The Python package name (auto-formatted if needed).
3. **Framework**: Choose from available agent frameworks.
4. **Network**: Choose from available blockchain networks.
5. **Chain ID**: Specify if using a custom network.
6. **Wallet Provider**: Select a preferred method for wallet management.
After answering the prompts, the CLI will:
- Generate the project structure.
- Copy necessary template files.
- Configure the selected settings.
- Display next steps to get started.
## Getting Started
Once your project is created, navigate into the directory and install dependencies:
```sh
cd my-project
poetry install
```
Then, configure your environment variables:
```sh
mv .env.local .env
```
Run the chatbot:
```sh
poetry run python chatbot.py
```
## Documentation & Support
- **Docs:** [https://docs.cdp.coinbase.com/agentkit/docs/welcome](https://docs.cdp.coinbase.com/agentkit/docs/welcome)
- **GitHub Repo:** [http://github.com/coinbase/agentkit](http://github.com/coinbase/agentkit)
- **Community & Support:** [https://discord.gg/CDP](https://discord.gg/CDP)
Raw data
{
"_id": null,
"home_page": null,
"name": "create-onchain-agent",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "agent, agentkit, ai, cdp, coinbase, crypto, sdk",
"author": null,
"author_email": "Carson Roscoe <carsonroscoe7@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/3c/a0/ea592150fd1df7596e5c4fd0b1c8ae65d656a863914d928b75a9ed4f5fad/create_onchain_agent-0.8.0.tar.gz",
"platform": null,
"description": "# create-onchain-agent\n\n## Overview\n\n`create-onchain-agent` is a CLI tool powered by [AgentKit](https://github.com/coinbase/agentkit) that allows developers to quickly scaffold an **onchain agent** project. This tool simplifies the setup process by generating a chatbot with predefined configurations, including blockchain network selection and wallet providers.\n\n## Requirements\n\nTo use `create-onchain-agent`, you must first setup:\n- **Python**: [Install Python](https://realpython.com/installing-python/) version 3.10 or 3.11\n- **Pipx**: [Install pipx](https://pipx.pypa.io/stable/installation/) using Python version 3.10 or 3.11\n\n**NOTE:** If you have multiple versions of Python installed, you can specify the Python version when installing pipx.\n\ne.g.:\n```sh\npython3.10 -m pip install --user pipx\npython3.10 -m pipx ensurepath\n```\n\n## Usage\n\nTo use `create-onchain-agent`, simply run:\n\n```sh\npipx run create-onchain-agent\n```\n\nThis command will guide you through setting up an onchain agent project by prompting for necessary configuration options.\n\n### Beginner Mode\n\nIf you are a beginner to web3 agents, we recommend running the command with the `beginner` flag:\n\n```sh\npipx run create-onchain-agent --beginner\n```\n\nThis will create a simplified chatbot with our recommended configurations, so you can get started quickly, without having to worry about the underlying details.\n\n## Features\n\n- **Guided setup**: Interactive prompts help configure the project.\n- **Supports multiple agent frameworks**.\n- **Supports multiple blockchain networks**.\n- **Select your preferred wallet provider**.\n- **Automates environment setup**.\n\n### Setup Process\n\nThe CLI will prompt you for the following details:\n\n1. **Project Name**: The name of your new onchain agent project.\n2. **Package Name**: The Python package name (auto-formatted if needed).\n3. **Framework**: Choose from available agent frameworks.\n4. **Network**: Choose from available blockchain networks.\n5. **Chain ID**: Specify if using a custom network.\n6. **Wallet Provider**: Select a preferred method for wallet management.\n\nAfter answering the prompts, the CLI will:\n\n- Generate the project structure.\n- Copy necessary template files.\n- Configure the selected settings.\n- Display next steps to get started.\n\n## Getting Started\n\nOnce your project is created, navigate into the directory and install dependencies:\n\n```sh\ncd my-project\npoetry install\n```\n\nThen, configure your environment variables:\n\n```sh\nmv .env.local .env\n```\n\nRun the chatbot:\n\n```sh\npoetry run python chatbot.py\n```\n\n## Documentation & Support\n\n- **Docs:** [https://docs.cdp.coinbase.com/agentkit/docs/welcome](https://docs.cdp.coinbase.com/agentkit/docs/welcome)\n- **GitHub Repo:** [http://github.com/coinbase/agentkit](http://github.com/coinbase/agentkit)\n- **Community & Support:** [https://discord.gg/CDP](https://discord.gg/CDP)\n",
"bugtrack_url": null,
"license": null,
"summary": "CLI to create an onchain agent project",
"version": "0.8.0",
"project_urls": null,
"split_keywords": [
"agent",
" agentkit",
" ai",
" cdp",
" coinbase",
" crypto",
" sdk"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "263723a22da968ffb7d9119a5775aa964542c607414f43fdc09956dff43b2242",
"md5": "7cdb757970ecd000a7baa6ff81fa6a38",
"sha256": "b177cb9c76821a9384515f62db46310ab7c91f7ef061b50491e5d556080dec74"
},
"downloads": -1,
"filename": "create_onchain_agent-0.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7cdb757970ecd000a7baa6ff81fa6a38",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 7525,
"upload_time": "2025-07-18T20:22:28",
"upload_time_iso_8601": "2025-07-18T20:22:28.289981Z",
"url": "https://files.pythonhosted.org/packages/26/37/23a22da968ffb7d9119a5775aa964542c607414f43fdc09956dff43b2242/create_onchain_agent-0.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3ca0ea592150fd1df7596e5c4fd0b1c8ae65d656a863914d928b75a9ed4f5fad",
"md5": "e5db5368f9e1da9058756a776f460d66",
"sha256": "cf208362d3ba20c5171eb9a8d2114513a85f13a97c98b68bd91e960de0a79f8e"
},
"downloads": -1,
"filename": "create_onchain_agent-0.8.0.tar.gz",
"has_sig": false,
"md5_digest": "e5db5368f9e1da9058756a776f460d66",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 7628,
"upload_time": "2025-07-18T20:22:29",
"upload_time_iso_8601": "2025-07-18T20:22:29.720783Z",
"url": "https://files.pythonhosted.org/packages/3c/a0/ea592150fd1df7596e5c4fd0b1c8ae65d656a863914d928b75a9ed4f5fad/create_onchain_agent-0.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 20:22:29",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "create-onchain-agent"
}