Configuration

MuninnDB uses a YAML config file (muninndb.yaml) in the working directory. All settings have sensible defaults — no config needed for development.

muninndb.yaml — full reference

# Server ports
server:
  mbp_port:  8747          # Muninn Binary Protocol
  grpc_port: 8748          # gRPC
  rest_port: 8749          # REST/HTTP
  ui_port:   8750          # Web UI
  data_dir:  ./data        # Storage directory

# Cognitive worker schedules
cognitive:
  decay_interval:       5m     # Ebbinghaus decay sweep frequency
  hebbian_interval:     1m     # Hebbian weight update frequency
  confidence_interval:  10m    # Bayesian confidence update frequency
  contradiction_interval: 30m  # Contradiction detection sweep
  decay_floor:          0.05   # Minimum relevance score (never reaches 0)
  hebbian_boost:        0.1    # Multiplicative boost per co-activation

# L1 cache (hot engrams in memory)
cache:
  l1_max_entries: 10000
  l1_ttl:         10m

# Authentication
auth:
  require_key: true            # Set false for local dev
  admin_key_env: MUNINN_ADMIN  # Env var for admin token

# Logging
logging:
  level:  info                 # debug, info, warn, error
  format: json                 # json or text

# Observability
metrics:
  enabled: true
  port:    9090                # Prometheus scrape port

# Plugins (optional)
plugins:
  embed:
    enabled:     false
    provider:    ollama        # ollama or openai
    model:       nomic-embed-text
    base_url:    http://localhost:11434
    retroactive: false

  enrich:
    enabled:     false
    provider:    openai
    model:       gpt-4o-mini
    retroactive: false