---
title: "nexus.config.yaml"
description: "The main configuration file for your Nexus OS project. Section Purpose project Project name version Config version agents Agent definitions supervisors Supervisor trees cost Budget settings trust AXIS requirements broker"
resource: https://www.aiagents.nexus/docs/manual/configuration/nexus-config-yaml
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# nexus.config.yaml Reference

The main configuration file for your Nexus OS project.

## Minimal Configuration

```yaml
project: my-project
version: "0.1"
```

## Full Configuration

```yaml
project: my-project
version: "0.1"

# Agent definitions
agents:
  researcher:
    template: researcher
    autoStart: true
  analyzer:
    template: analyzer
    autoStart: false

# Supervisor configuration
supervisors:
  main:
    strategy: one-for-one
    maxRestarts: 3
    restartWindow: 60
    children:
      - researcher
      - analyzer

# Cost control
cost:
  budgets:
    researcher:
      limit: 1000      # cents ($10.00)
      period: day
      onExceed: pause
      alertAt: 80       # alert at 80% usage

# Trust requirements
trust:
  provider: axis
  requirements:
    minTrustTier: T3
    minTScore: 70
  enforcement:
    onUntrusted: reject

# Broker routing
broker:
  preferences:
    preferLocal: true
    maxLLMCost: 500
    confidenceThreshold: 0.85

# Skills
skills:
  summarize:
    patterns:
      - summarize
      - summary
      - tldr
    handler: skills/summarize.wasm
    costPerCall: 0

# Edge deployment
edge:
  provider: cloudflare
  regions:
    - us
    - eu
    - asia
  autoDeploy: false
```

## Section Reference

| Section | Purpose |
|---------|---------|
| `project` | Project name |
| `version` | Config version |
| `agents` | Agent definitions |
| `supervisors` | Supervisor trees |
| `cost` | Budget settings |
| `trust` | AXIS requirements |
| `broker` | Routing preferences |
| `skills` | Skill definitions |
| `edge` | Edge deployment |