---
title: "Agent Configuration"
description: "Configure individual agents in nexus.config.yaml . 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 li"
resource: https://www.aiagents.nexus/docs/manual/configuration/agent-configuration
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# 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
```