Metadata-Version: 2.3
Name: create-agentverse-agent
Version: 0.2.0
Summary: A tool to create Agentverse compatible agents based on uAgents framework.
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 :: 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.12.5
Requires-Dist: rich>=14.2.0
Requires-Dist: typer>=0.21.1
Requires-Python: >=3.12
Project-URL: Changelog, https://github.com/tejus3131/create-agentverse-agent/releases
Project-URL: Documentation, https://github.com/tejus3131/create-agentverse-agent#readme
Project-URL: Homepage, https://github.com/tejus3131/create-agentverse-agent
Project-URL: Issues, https://github.com/tejus3131/create-agentverse-agent/issues
Project-URL: Repository, https://github.com/tejus3131/create-agentverse-agent
Description-Content-Type: text/markdown

![PyPI](https://img.shields.io/pypi/v/create-agentverse-agent)
![Python](https://img.shields.io/pypi/pyversions/create-agentverse-agent)
![License](https://img.shields.io/pypi/l/create-agentverse-agent)
![CI](https://github.com/tejus3131/create-agentverse-agent/actions/workflows/ci.yml/badge.svg)
![Black](https://img.shields.io/badge/code%20style-black-000000.svg)
![Ruff](https://img.shields.io/badge/lint-ruff-red)
![Mypy](https://img.shields.io/badge/type%20check-mypy-blue)
![Tests](https://img.shields.io/badge/tests-passing-brightgreen)

# create-agentverse-agent

A CLI tool to scaffold **production-ready uAgents** with best practices baked in — in seconds.

---

## 🚀 Why this exists

Building agents with **uAgents** is powerful, but setting things up *correctly* every time is not trivial.

This tool solves that by generating a **production-grade agent scaffold** with:

- ⚡ Parallel message processing
- 🧠 Context-aware logging
- 📡 Progress / status message support
- 🩺 Built-in health & quota protocol
- 🤖 Automatic Agentverse compatibility
- 🧱 Clean, extensible project structure
- 🛠 Sensible defaults that don’t fight you later

Instead of starting from scratch (or copying old projects), you get a **clean, consistent, battle-tested starting point** every time.

---

## 👥 Who is this for?

This tool is designed for **all of the following**:

- uAgents developers
- Agentverse builders
- Hackathon & rapid-prototyping teams
- Python developers who want a clean CLI-driven workflow

If you build agents more than once — this saves you time.

---

## 📦 Installation

### ⭐ Recommended: `uvx` (no install, like `npx`)

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

That’s it. No environment pollution, no setup.

---

### Using `pipx` (global, isolated)

```bash
pipx install create-agentverse-agent
create-agentverse-agent
```

---

### Using `pip`

```bash
pip install create-agentverse-agent
create-agentverse-agent
```

---

### Using Poetry

```bash
poetry add create-agentverse-agent
poetry run create-agentverse-agent
```

---

## 🧑‍💻 Usage

### Interactive setup (recommended)

Launch the interactive wizard to configure your agent step by step:

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

---

### Quick start with defaults

Skip all prompts and generate an agent using sensible defaults:

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

Ideal for rapid prototyping, automation, or CI pipelines.

---

### Advanced configuration mode

Enable **advanced mode** to access all available configuration options:

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

Use this if you want full control over the generated agent setup.

---

### Overwrite existing project

If a project already exists in the target directory, you can overwrite it:

```bash
uvx create-agentverse-agent --overwrite
# or
uvx create-agentverse-agent -o
```

⚠️ This will replace existing files.

---

### Debug mode

Run the CLI with debug logging enabled.
A detailed log file will be created in the current directory:

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

Log file format:

```
uvx create-agentverse-agent-<version>-cli-execution-<uuid>.log
```

Useful for troubleshooting or reporting issues.

---

### Show version

Display the installed version and exit:

```bash
uvx create-agentverse-agent --version
# or
uvx create-agentverse-agent -v
```

---

### Help

Show the full help message with all options and examples:

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

---

## 🧱 What gets generated?

The scaffold is designed to be **production-ready from day one**, not a demo:

* Agent entrypoint
* Proper async message handling
* Agentverse-compatible configuration
* Logging & context utilities
* Health & quota protocol support
* Docker & Docker Compose templates
* Clean dependency management
* Minimal but extensible structure

You can ship this, not just demo it.

---

## 🧠 Design philosophy

* **Opinionated, but not restrictive**
* **Defaults that scale**
* **Explicit over clever**
* **Production first, demos second**

This tool exists because repeatedly hand-rolling agent scaffolds is boring — and error-prone.

---

## 🧑‍🏫 Author

**Tejus Gupta**
🌐 [https://tejusgupta.dev](https://tejusgupta.dev)
📧 [hello@tejusgupta.dev](mailto:hello@tejusgupta.dev)

Built as a weekend project — because sometimes the best tools come from *personal pain* 😭

---

## 📄 License

MIT License.
See [`LICENSE`](LICENSE) for details.

---

## 🤝 Contributing

Contributions are welcome!

Please read:
- [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines
- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) to understand community expectations
- [CHANGELOG.md](CHANGELOG.md) to see recent changes
