create-agentverse-agent 0.2.7

A tool to create Agentverse compatible agents based on uAgents framework.

create-agentverse-agent

📖 Full Documentation: create-agentverse-agent.tech

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
• 🤖 Agentverse-compatible Agents
• 🧱 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

📦 PyPI: https://pypi.org/project/create-agentverse-agent/

⭐ Recommended: uvx (no install, like npx)

uvx create-agentverse-agent

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

---

Using pipx (global, isolated)

pipx install create-agentverse-agent
create-agentverse-agent

---

Using pip

pip install create-agentverse-agent
create-agentverse-agent

---

Using Poetry

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:

uvx create-agentverse-agent

---

Quick start with defaults

Skip all prompts and generate an agent using sensible defaults:

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:

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:

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:

uvx create-agentverse-agent --debug

Log file format:

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

Useful for troubleshooting or reporting issues.

---

Show version

Display the installed version and exit:

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

---

Help

Show the full help message with all options and examples:

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.

---

📚 Documentation

Full documentation is available at create-agentverse-agent.tech

Guide	Description
Installation	Multiple installation methods
Usage	CLI options and examples
Generated Structure	What gets created
Configuration	Customization options

---

🧠 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 📧 [e-mail]

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

---

📄 License

MIT License. See LICENSE for details.

---

🤝 Contributing

Contributions are welcome!

Please read:

• CONTRIBUTING.md for development setup and guidelines
• CODE_OF_CONDUCT.md to understand community expectations
• CHANGELOG.md to see recent changes

---

Made with ❤️ by Tejus Gupta.