Agent Configuration

Configure individual agents in nexus.config.yaml.

Basic Agent

yaml

agents:
  my-agent:
    template: researcher

Full Agent Configuration

yaml

agents:
  researcher:
    template: researcher
    autoStart: true
    wasm:
      fuel: 1000000        # Max WASM fuel
      memoryPages: 256     # Max memory (256 × 64KB = 16MB)
    env:
      API_KEY: "sk-..."
      MODEL: "claude-3-sonnet"
    metadata:
      team: research
      priority: high

Configuration Fields

Field	Type	Default	Description
`template`	string	required	Agent template name
`autoStart`	bool	false	Start agent on project load
`wasm.fuel`	int	1000000	WASM execution fuel limit
`wasm.memoryPages`	int	256	WASM memory page limit
`env`	map	{}	Environment variables for the agent
`metadata`	map	{}	Custom metadata tags

Templates

Available built-in templates:

Template	Description
`researcher`	Web research and summarization
`analyzer`	Data analysis and reporting
`coder`	Code generation and review
`planner`	Task planning and decomposition
`custom`	Blank template for custom agents

bash

# Create with template
naos create my-agent --template researcher

# List available templates
naos templates

Environment Variables

Advanced Options