nexus.config.yaml Reference

The main configuration file for your Nexus OS project.

Minimal Configuration

project: my-project
version: "0.1"

Full Configuration

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