---
title: "Creating Agents"
description: "Available 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 Defi"
resource: https://www.aiagents.nexus/docs/manual/agents/creating-agents
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Creating Agents

## From a Template

```bash
naos create my-agent --template researcher
```

Available 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 |

## From Configuration

Define agents in `nexus.config.yaml`:

```yaml
agents:
  researcher:
    template: researcher
    autoStart: true
  analyzer:
    template: analyzer
    env:
      MODEL: claude-3-sonnet
```

Then create all configured agents:

```bash
naos create --from-config
```

## Verify Creation

```bash
naos status

# NAME         STATUS    ID
# researcher   stopped   a1b2c3d4e5f6
# analyzer     stopped   b2c3d4e5f6a1
```

## Agent Naming Rules

- Lowercase letters, numbers, and hyphens only
- Must start with a letter
- Maximum 64 characters
- Must be unique within the project

```bash
# ✓ Valid names
naos create my-agent
naos create data-processor-v2
naos create agent123

# ✗ Invalid names
naos create My-Agent        # uppercase
naos create 123-agent       # starts with number
naos create my_agent        # underscores
```