📖 Full Documentation: create-agentverse-agent.tech
A CLI tool to scaffold production-ready uAgents with best practices baked in — in seconds.
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.
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.
uvx create-agentverse-agentThat’s it. No environment pollution, no setup.
pipx install create-agentverse-agent
create-agentverse-agentpip install create-agentverse-agent
create-agentverse-agentpoetry add create-agentverse-agent
poetry run create-agentverse-agentLaunch the interactive wizard to configure your agent step by step:
uvx create-agentverse-agentSkip all prompts and generate an agent using sensible defaults:
uvx create-agentverse-agent --default
# or
uvx create-agentverse-agent -dIdeal for rapid prototyping, automation, or CI pipelines.
Enable advanced mode to access all available configuration options:
uvx create-agentverse-agent --advanced
# or
uvx create-agentverse-agent -aUse this if you want full control over the generated agent setup.
If a project already exists in the target directory, you can overwrite it:
uvx create-agentverse-agent --overwrite
# or
uvx create-agentverse-agent -oRun the CLI with debug logging enabled. A detailed log file will be created in the current directory:
uvx create-agentverse-agent --debugLog file format:
create-agentverse-agent-<version>-cli-execution-<uuid>.log
Useful for troubleshooting or reporting issues.
Display the installed version and exit:
uvx create-agentverse-agent --version
# or
uvx create-agentverse-agent -vShow the full help message with all options and examples:
uvx create-agentverse-agent --helpThe 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.
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 |
- 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.
Tejus Gupta 🌐 https://tejusgupta.dev 📧 hello@tejusgupta.dev
Built as a weekend project — because sometimes the best tools come from personal pain 😭
MIT License.
See LICENSE for details.
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.