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.dev202503290

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

Built distribution (wheel)

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

Total release size: 13.1 kB

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

Download URL create_onchain_agent-0.4.1.dev202503290.tar.gz
Size 6.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5ff393a305e1d7e7511982ebb0fc1f61f96ae63bb9f24252470e8cc88408545a
BLAKE2b-256 checksum
How to use checksums
f3dd93d1386898e2e196a71fe985cf23f2049faccc7da5635007ab49e9a6b6ff
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 29, 2025.

Transparency log

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

Download URL create_onchain_agent-0.4.1.dev202503290-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ede5a9e0ff049d3561666ba8cf99a92838daddeb08a4871f05cbcbc9e04501ff
BLAKE2b-256 checksum
How to use checksums
016a923c880b1f7140ad2c90226dac72787472e3089b98deeed62eaf86d4dc85
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 29, 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