Quick Start

npx @agenium/create-agent my-agent
cd my-agent
npm start

Done. Your agent has an agent://my-agent identity and is live on the network.

Why?

Building an AI agent shouldn't require wiring up HTTP servers, TLS certs, and service discovery from scratch. This scaffold gives you:

• ✅ Identity — agent://name URI on the AGENIUM network
• ✅ Discovery — Other agents find yours by name
• ✅ Communication — Stateful sessions with mTLS
• ✅ Docker — Production-ready container included
• ✅ TypeScript — Full type safety

Templates

| Template | Best for | What you get | |----------|----------|-------------| | echo | Hello world | Minimal agent — echo, ping, info | | tools | Custom logic | Add your own tools and handlers | | api | REST wrappers | Expose any REST API as agent tools |

# Choose a template
npx @agenium/create-agent my-agent --template=tools

# Non-interactive (use defaults)
npx @agenium/create-agent my-agent --yes

What Gets Generated

my-agent/
├── src/index.ts      # Your agent (edit this!)
├── package.json      # agenium SDK pre-installed
├── tsconfig.json     # TypeScript ready
├── Dockerfile        # Deploy anywhere
├── .env              # API key goes here
└── README.md         # Project docs

Next Steps

1. Edit src/index.ts — add your tools and logic
2. Run npm run dev — test locally
3. Register at marketplace.agenium.net — get your API key
4. Deploy — npm run docker:build for production

Options

| Flag | Description | |------|-------------| | --template=<name> | echo, tools, or api | | --port=<number> | Listen port (default: 9001) | | --yes / -y | Non-interactive mode | | --no-install | Skip npm install | | --no-git | Skip git init |

Part of the AGENIUM Ecosystem

| Package | Description | |---------|-------------| | agenium | Core agent SDK | | @agenium/create-agent | ← You are here | | @agenium/mcp-server | Bridge MCP servers → agent:// |

🔍 Find MCP Servers

Search 2,000+ MCP servers →

Links

• 📖 Documentation
• 🤖 Live Demo
• 💬 Discord
• 🐦 Twitter/X

License

MIT © AGENIUM