Skip to main content

create-onchain-agent

Overview

create-onchain-agent is a CLI tool powered by 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:

NOTE: If you have multiple versions of Python installed, you can specify the Python version when installing pipx.

e.g.:

python3.10 -m pip install --user pipx
python3.10 -m pipx ensurepath

Usage

To use create-onchain-agent, simply run:

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:

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:

cd my-project
poetry install

Then, configure your environment variables:

mv .env.local .env

Run the chatbot:

poetry run python chatbot.py

Documentation & Support

Release files for create-onchain-agent 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for create-onchain-agent 0.9.0
File Size Uploaded
create_onchain_agent-0.9.0.tar.gz 7.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for create-onchain-agent 0.9.0
File Interpreter ABI Platform
create_onchain_agent-0.9.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.2 kB

Release files / create_onchain_agent-0.9.0.tar.gz

Download URL create_onchain_agent-0.9.0.tar.gz
Size 7.6 kB
Tags Source
SHA-256 checksum
How to use checksums
ccbf421ecae41b38c8bc8c4b7d5b518f818515896026353886909353c68e0b3f
BLAKE2b-256 checksum
How to use checksums
a147bff36399acae3af5fce21064c8367e0e8575e3cdafee8c4c04d2b64ab23a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 6, 2025.

Transparency log

Release files / create_onchain_agent-0.9.0-py3-none-any.whl

Download URL create_onchain_agent-0.9.0-py3-none-any.whl
Size 7.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
995ef919ca1030d03e5712c36dc3efd259af976218f56fb3d1f578ec1b736c8e
BLAKE2b-256 checksum
How to use checksums
84f662bb61c042bcba071b8f1a91110aa889e3ad850ea792f8e541556e2576a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 6, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.9.0 This release

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page