Metadata-Version: 2.3
Name: create-agentverse-agent
Version: 1.0.0
Summary: Scaffold production-ready uAgents projects with Postgres-backed multipod runtime.
Keywords: agents,agentverse,uagents,ai-agents,cli,code-generator
Author: Tejus Gupta
Author-email: Tejus Gupta <tejus3131@tejusgupta.dev>
License: MIT License
         
         Copyright (c) 2026 Tejus Gupta
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
         in the Software without restriction, including without limitation the rights
         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
         copies of the Software, and to permit persons to whom the Software is
         furnished to do so, subject to the following conditions:
         
         The above copyright notice and this permission notice shall be included in all
         copies or substantial portions of the Software.
         
         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries
Classifier: Environment :: Console
Classifier: Typing :: Typed
Requires-Dist: jinja2>=3.1.6
Requires-Dist: pydantic>=2.13.4
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: rich>=15.0.0
Requires-Dist: typer>=0.26.7
Requires-Python: >=3.12
Project-URL: Homepage, https://create-agentverse-agent.tech/
Project-URL: Repository, https://github.com/tejus3131/create-agentverse-agent
Project-URL: Issues, https://github.com/tejus3131/create-agentverse-agent/issues
Project-URL: Documentation, https://create-agentverse-agent.tech/
Project-URL: Changelog, https://github.com/tejus3131/create-agentverse-agent/releases
Description-Content-Type: text/markdown

# create-agentverse-agent

[![Fetch.ai](https://img.shields.io/badge/Fetch.ai-Ecosystem-blue?logo=fetch.ai&logoColor=white)](https://fetch.ai)
[![PyPI](https://img.shields.io/pypi/v/create-agentverse-agent?cacheSeconds=300)](https://pypi.org/project/create-agentverse-agent/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/create-agentverse-agent?cacheSeconds=300)](https://pypi.org/project/create-agentverse-agent/)
[![License](https://img.shields.io/github/license/tejus3131/create-agentverse-agent)](LICENSE)
[![CI](https://github.com/tejus3131/create-agentverse-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/tejus3131/create-agentverse-agent/actions/workflows/ci.yml)
[![Docs](https://img.shields.io/badge/docs-github--pages-blue)](https://create-agentverse-agent.tech/)

> **Full Documentation:** [create-agentverse-agent.tech](https://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](https://github.com/astral-sh/uv) (recommended)

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

Test the CLI from a local checkout:

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

---

## Installation

### Recommended: `uvx` (no install)

```bash
uvx create-agentverse-agent
```

### Other methods

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

---

## Usage

### Interactive setup

```bash
uvx create-agentverse-agent
```

### Quick start with defaults

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

### Advanced configuration

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

### Overwrite existing project

```bash
uvx create-agentverse-agent --overwrite
```

### Debug logging

```bash
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

```bash
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](https://create-agentverse-agent.tech/installation) | Install methods |
| [Getting Started](https://create-agentverse-agent.tech/getting-started) | End-to-end tutorial |
| [Usage](https://create-agentverse-agent.tech/usage) | CLI options |
| [Generated Structure](https://create-agentverse-agent.tech/structure) | Project layout |
| [Configuration](https://create-agentverse-agent.tech/configuration) | agent.yml + .env reference |
| [Architecture](https://create-agentverse-agent.tech/architecture) | Runtime design |
| [Handler Guide](https://create-agentverse-agent.tech/handler) | Writing agent logic |
| [Agentverse](https://create-agentverse-agent.tech/agentverse) | Registration and profile |
| [Migration](https://create-agentverse-agent.tech/migration) | Upgrading from 0.2.x |

---

## Author

**Tejus Gupta** — [tejusgupta.dev](https://tejusgupta.dev)

---

## License

MIT — see [LICENSE](LICENSE).

---

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). Runtime bundle sync procedure documented there.
