Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.4.1.dev202503300

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.4.1.dev202503300
File Size Uploaded
create_onchain_agent-0.4.1.dev202503300.tar.gz 6.2 kB Details

Built distribution (wheel)

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

Total release size: 13.1 kB

Release files / create_onchain_agent-0.4.1.dev202503300.tar.gz

Download URL create_onchain_agent-0.4.1.dev202503300.tar.gz
Size 6.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f82b8929637eb86c9969c74c751f0f253ea76659eebf0f1367793d576a3bc635
BLAKE2b-256 checksum
How to use checksums
b52ba96b32c00cc63fc39d67c72f6306fe97eb181a240b40f95a6e3455733f1b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

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 Mar 30, 2025.

Transparency log

Release files / create_onchain_agent-0.4.1.dev202503300-py3-none-any.whl

Download URL create_onchain_agent-0.4.1.dev202503300-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1c81f0a7ffc959cfda8c0ee71dbe1d78826b2c96e35ad56623a5d6114e66753c
BLAKE2b-256 checksum
How to use checksums
4fa0298a7b6f107f6ae697f6369b170b335be5500aa31d96d12da31accac191f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

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 Mar 30, 2025.

Transparency log

Release history Release notifications | RSS feed

0.9.0

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

This release

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