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

SectionPurpose
projectProject name
versionConfig version
agentsAgent definitions
supervisorsSupervisor trees
costBudget settings
trustAXIS requirements
brokerRouting preferences
skillsSkill definitions
edgeEdge deployment