Droid (Factory)

Factory's Droid supports custom OpenAI-compatible models through its settings.json configuration. You can add ModelBridge models alongside Droid's built-in models.

Quick setup

Paste your API key into the field below, select your models, then copy the generated config into ~/.factory/settings.json:

{
  "customModels": [
    {
      "model": "claude-sonnet-4-6",
      "id": "custom:claude-sonnet-4-6",
      "index": 0,
      "baseUrl": "https://api.modelbridge.dev/v1",
      "apiKey": "mb_live_your_key_here",
      "displayName": "Claude Sonnet 4.6",
      "maxOutputTokens": 16384,
      "reasoningEffort": "high",
      "noImageSupport": false,
      "provider": "generic-chat-completion-api"}
  ]
}

If the file doesn't exist, create it with the content above. If it already exists, merge the customModels array into your existing config.

Configuration fields

Each model entry in the customModels array uses these fields:

• model -- The model ID (must match a ModelBridge model name exactly)
• id -- Unique identifier for the model entry (e.g. custom:claude-sonnet-4-6)
• displayName -- How the model appears in Droid's model picker
• baseUrl -- Set to https://api.modelbridge.dev/v1
• apiKey -- Your ModelBridge API key
• provider -- Must be generic-chat-completion-api for OpenAI-compatible endpoints
• maxOutputTokens -- Maximum tokens for responses (16384 is a good default)
• reasoningEffort -- Default reasoning effort (high, medium, or low) -- toggleable in Droid's UI
• noImageSupport -- Set to false to enable image/vision support

Using models in Droid

Once configured, your ModelBridge models appear in Droid's model selector. You can:

• Select them from the model picker in any session
• Toggle reasoning effort per-model from Droid's UI
• Reference them in droid configurations and custom droids
• Use them alongside Droid's built-in models

Available models