Skip to main content

Configuration Overview

Sinaptic® DROID+ uses two types of YAML configuration files:

Main Config (droid.yaml)​

The main config file controls the runtime: server ports, LLM provider credentials, security settings, logging, and paths.

edition: community

server:
  openai_port: 8080
  management_port: 8081

llm:
  provider: openai
  api_key: ${OPENAI_API_KEY}
  default_model: gpt-4o-mini

sinaptic:
  enabled: true
  mode: block

logging:
  level: info
  format: json

agents_dir: ./configs/agents

Sinaptic® DROID+ looks for droid.yaml in the current directory by default, or you can specify a path with droid up --config /path/to/droid.yaml.

Agent Configs (configs/agents/*.yaml)​

Each agent gets its own YAML file. The agent's name field becomes the model parameter in API calls.

name: my-agent
description: A helpful assistant

model:
  name: gpt-4o-mini
  max_tokens: 1024
  temperature: 0.7

personality: |
  You are a helpful assistant. Be concise and accurate.

tools:
  - name: web-search
    type: mcp

Sinaptic® DROID+ loads all .yaml files from the agents_dir directory at startup and watches for changes to hot-reload.

Environment Variable Substitution​

All config values support ${ENV_VAR} syntax. Sinaptic® DROID+ resolves them at startup:

llm:
  api_key: ${OPENAI_API_KEY}    # Resolved from environment

Use a .env file in the project root for local development. Sinaptic® DROID+ loads it automatically.

Further Reading​