Configuration

The Xybrid CLI can be configured via YAML files at the global or project level.

Configuration Files

Scope	Path	Description
Global	`~/.config/xybrid/config.yml`	User-wide defaults
Project	`./.xybrid/config.yml`	Project-specific overrides

Project configuration takes precedence over global configuration.

Registry Configuration

Local Registry

registry:
  name: "local"
  path: "~/.xybrid/registry"

S3 Registry

registry:
  name: "main"
  uri: "s3://xybrid-models"
  credentials:
    access_key: "${AWS_ACCESS_KEY_ID}"
    secret_key: "${AWS_SECRET_ACCESS_KEY}"

HTTP Registry

registry:
  name: "prod"
  base_url: "https://registry.xybrid.dev/"
  auth:
    type: bearer
    token: "${XYBRID_REGISTRY_TOKEN}"
  timeout_ms: 5000
  retry_attempts: 3

Telemetry Configuration

telemetry:
  enabled: true
  endpoint: "http://localhost:4318"
  sampling_rate: 0.05
  privacy_mode: "summary_only"

Option	Default	Description
`enabled`	`true`	Enable/disable telemetry collection
`endpoint`	-	OpenTelemetry collector endpoint
`sampling_rate`	`1.0`	Fraction of traces to sample (0.0-1.0)
`privacy_mode`	`full`	`full`, `summary_only`, or `none`

Environment Variables

Configuration values can reference environment variables using ${VAR_NAME} syntax:

registry:
  auth:
    token: "${XYBRID_REGISTRY_TOKEN}"

Common environment variables:

Variable	Description
`XYBRID_REGISTRY_TOKEN`	Authentication token for remote registry
`XYBRID_API_KEY`	API key for cloud integrations
`OPENAI_API_KEY`	OpenAI API key (for integration stages)
`ANTHROPIC_API_KEY`	Anthropic API key

Example Configuration

Complete configuration example:

# ~/.config/xybrid/config.yml

registry:
  name: "prod"
  base_url: "https://registry.xybrid.dev/"
  auth:
    type: bearer
    token: "${XYBRID_REGISTRY_TOKEN}"
  timeout_ms: 10000
  retry_attempts: 3

telemetry:
  enabled: true
  endpoint: "https://telemetry.xybrid.dev"
  sampling_rate: 0.1
  privacy_mode: "summary_only"

defaults:
  target: "auto"
  log_level: "info"

Configuration

On this page