initializdocs
DeveloperForge runtimeGetting started

Configuration

Configure your Forge agent with forge.yaml and environment variables.

All Forge agent configuration lives in forge.yaml at the project root.

Quick Start

A minimal forge.yaml:

agent_id: "my-agent"
version: "1.0.0"

model:
  provider: "openai"
  name: "gpt-4o"

tools:
  - name: "web_search"
  - name: "cli_execute"
    config:
      allowed_binaries: ["git", "curl"]

Key Sections

SectionPurpose
modelLLM provider, model name, fallback chain
toolsBuiltin and custom tool configuration
channelsMessaging platform adapters (Slack, Telegram)
egressOutbound network access controls
memorySession persistence and long-term memory
secretsEncrypted secret storage providers
schedulesRecurring cron-based tasks

For the complete schema, see forge.yaml Schema.

For all environment variable overrides, see Environment Variables.

On this page