create-agentverse-agent

Full Documentation: create-agentverse-agent.tech

CLI to scaffold production-ready uAgents with a Postgres-backed multipod runtime, chat + payment protocols, and Agentverse registration.

---

Why this exists

Building agents with uAgents is powerful, but a production-grade setup — Postgres coordination, rate limits, payments, multipod runtime — is a lot to hand-roll every time.

This tool generates a complete project in seconds:

• Postgres-backed work queue, session locks, and idempotency
• Chat and payment protocol wiring
• FET, Stripe, and Skyfire payment support (configurable)
• Smart Agentverse registration on startup
• Dual config: agent.yml (non-secret) + .env (secrets)
• Docker Compose for local Postgres + agent
• uv-based Python 3.13 workflow

---

Prerequisites

CLI tool: Python 3.12+, uv (recommended)

Generated projects: Python 3.13, uv, Docker (Postgres via Compose)

Test the CLI from a local checkout:

uvx --from . create-agentverse-agent -d

---

Installation

Recommended: uvx (no install)

uvx create-agentverse-agent

Other methods

pipx install create-agentverse-agent
# or
pip install create-agentverse-agent

---

Usage

Interactive setup

uvx create-agentverse-agent

Quick start with defaults

uvx create-agentverse-agent --default
# or
uvx create-agentverse-agent -d

Advanced configuration

uvx create-agentverse-agent --advanced
# or
uvx create-agentverse-agent -a

Overwrite existing project

uvx create-agentverse-agent --overwrite

Debug logging

uvx create-agentverse-agent --debug

---

What gets generated?

my-agent/
├── agent.yml              # Identity, protocols, runtime config
├── .env                   # Secrets (Postgres, API keys)
├── .env.example           # Reference for env vars
├── AGENTVERSE.md          # Agentverse profile readme
├── schema.sql             # Postgres coordination schema
├── docker-compose.yml     # Local Postgres + agent
├── Dockerfile             # Container build
├── pyproject.toml         # uv / hatch project
├── uv.lock                # Locked dependencies
├── Makefile               # db, test, run, down
├── src/agent/handler.py   # Your handler (edit this)
├── src/runtime/           # Framework runtime
└── src/shared/            # Settings and types

After scaffolding

cd my-agent
uv sync
make test    # Postgres in Docker + agent on host

Or full stack: make run. See make help.

---

Documentation

Guide	Description
Installation	Install methods
Getting Started	End-to-end tutorial
Usage	CLI options
Generated Structure	Project layout
Configuration	agent.yml + .env reference
Architecture	Runtime design
Handler Guide	Writing agent logic
Agentverse	Registration and profile
Migration	Upgrading from 0.2.x

---

Author

Tejus Gupta — tejusgupta.dev

---

License

MIT — see LICENSE.

---

Contributing

See CONTRIBUTING.md. Runtime bundle sync procedure documented there.