Setup Wizard
The Setup Wizard is a guided 4-step flow in the web portal that creates a venture, deploys an agent, and launches a first mission — all atomically in a single operation.
How to Open
- Start the Gateway:
mayros gateway - Open the portal:
mayros dashboard(or navigate tohttp://localhost:18789) - Go to the Ventures tab
- Click New Venture
Steps
Step 1: Venture
Define the venture basics:
| Field | Description | Required |
|---|---|---|
| Name | Venture display name | Yes |
| Directive | Top-level strategic directive | No |
| Prefix | Short prefix for mission IDs (e.g. SEC, ACM) | Yes |
| Fuel Limit | Maximum budget in integer cents (0 = unlimited) | No |
Step 2: Agent
Add the first agent to the venture:
| Field | Description | Required |
|---|---|---|
| Name | Agent identifier (alphanumeric) | Yes |
| Role | Agent role description (e.g. "Security Scanner") | Yes |
Step 3: Mission
Create the first mission for the venture:
| Field | Description | Required |
|---|---|---|
| Title | Mission title | Yes |
| Description | Detailed description of the work | No |
| Priority | critical, high, medium, or low (default: medium) | No |
Step 4: Launch
Review a summary of everything that will be created, then click Create & Launch.
The summary shows:
- Venture name, prefix, directive, and fuel limit
- Agent name and role
- Mission title, description, and priority
What Happens on Launch
Clicking Create & Launch calls the kaneru.setup gateway method, which atomically:
- Creates the venture with the specified name, prefix, directive, and fuel limit
- Deploys the agent with its role into the venture's chain of command
- Creates the first mission in
queuedstatus - Returns the IDs of all created entities
If any step fails, the entire operation is rolled back — no partial state is left behind.
Response
json{ "ventureId": "v-abc123", "agentId": "scanner", "missionId": "SEC-1" }
Navigation
The wizard supports forward and backward navigation:
- Next — advance to the next step (validates current step)
- Back — return to the previous step (preserves entered data)
- Create & Launch — appears only on Step 4
Going back from the Launch step clears any error state, allowing you to fix issues and retry.
Alternatives
The Setup Wizard is the fastest path for beginners. Power users have other options:
bash# CLI: create step by step mayros kaneru venture create --name "Acme" --prefix ACM --directive "Ship fast" --fuel-limit 10000 mayros kaneru mission create --venture <id> --title "First task" --priority medium # Dojo: install a pre-built template mayros kaneru dojo install --template security-audit --name "My Security Team"
Or use the MCP tools from Claude Desktop, Claude Code, or any MCP client.
Next Steps
- Ventures & Missions — detailed venture and mission management
- Dojo Templates — pre-built templates for common workflows
- Control UI — the web portal that hosts the wizard